ホーム › Media.DeviceManager › IWMDMObjectInfo

IWMDMObjectInfo

COM

IID1dcb3a09-33ed-11d3-8470-00c04f79dbc0継承元IUnknown自前メソッド開始 vtbl3

公式ドキュメント

IWMDMObjectInfo インターフェースは、デバイス上の再生可能なファイルを IWMDMDeviceControl インターフェースがどのように扱うかを制御する情報を取得および設定します。このインターフェースは、再生できないファイルを対象としたものではありません。

メソッド 7

vtbl = vtable インデックス(0始まり)。HSP等からCOMメソッドをインデックス指定で呼ぶ際に使用します。0〜2 は IUnknown。

vtbl 3 HRESULT GetPlayLength(DWORD* pdwLength)

GetPlayLength メソッドは、オブジェクトの再生長を、フォーマットに応じた単位で取得します。これはファイルの総再生時間ではなく、残りの再生可能な長さです。

pdwLength

DWORD*

out

ファイルの残りの再生長をミリ秒単位で示す DWORD へのポインター。

戻り値

このメソッドは HRESULT を返します。Windows Media Device Manager のすべてのインターフェースメソッドは、次の分類のエラーコードを返す可能性があります。

標準的な COM エラーコード
HRESULT 値に変換された Windows エラーコード
Windows Media Device Manager のエラーコード

発生しうるエラーコードの詳細な一覧については、Error Codes を参照してください。

解説(Remarks)

取得される再生長の値は、（SetPlayLength メソッドが呼び出されていない場合は）オブジェクトの総再生長から現在の再生位置を引いた値、または SetPlayLength で設定された値をオブジェクトの総再生長から現在の再生位置を引いた値以下に丸めたものになります。

再生長の情報は、ユーザーがメディアデバイス上でファイルの再生を開始したとき、またはアプリケーションが Play メソッドを呼び出したときに変化することがあります。

再生可能なファイルを含むフォルダーまたはファイルシステムの場合、返される値は、そのフォルダー内またはそのファイルシステムのルートにあるトラック数、すなわち再生可能なファイルの数になります。

vtbl 4 HRESULT SetPlayLength(DWORD dwLength)

SetPlayLength メソッドは、オブジェクトの再生長を、フォーマットに応じた単位で設定します。これは実際の長さにかかわらず、そのオブジェクトが再生される最大の長さです。

dwLength

DWORD

再生長をフォーマットに応じた単位で示す DWORD。

戻り値

標準的な COM エラーコード
HRESULT 値に変換された Windows エラーコード
Windows Media Device Manager のエラーコード

発生しうるエラーコードの詳細な一覧については、Error Codes を参照してください。

解説(Remarks)

渡された値がオブジェクトの総再生長より大きい場合、その値はオブジェクトの長さから現在の再生位置と 1 単位を引いた値に丸められます。

再生可能なファイルの場合、設定する値はミリ秒単位で指定します。値は、ファイルの総再生長からオブジェクトの現在の再生オフセット位置を引いた値以下に丸められます。再生位置の情報は、ユーザーがメディアデバイス上でファイルの再生を開始したとき、またはアプリケーションが IWMDMDeviceControl::Play メソッドを呼び出したときに変化することがあります。

再生可能なファイルを含むフォルダーまたはファイルシステムの場合、渡す値は、そのフォルダー内またはそのファイルシステムのルートにある再生可能なファイルの数になります。

vtbl 5 HRESULT GetPlayOffset(DWORD* pdwOffset)

GetPlayOffset メソッドは、オブジェクトの再生オフセットを、フォーマットに応じた単位で取得します。これは次回 Play を呼び出したときの開始位置です。

pdwOffset

DWORD*

out

オブジェクトの再生オフセットを、フォーマットに応じた単位で示す DWORD へのポインター。

戻り値

標準的な COM エラーコード
HRESULT 値に変換された Windows エラーコード
Windows Media Device Manager のエラーコード

発生しうるエラーコードの詳細な一覧については、Error Codes を参照してください。

解説(Remarks)

取得される値は、（SetPlayOffset メソッドが呼び出されていない場合は）0、または SetPlayOffset で設定された値をオブジェクトの総再生長から 1 単位を引いた値以下に丸めたものになります。

再生可能なファイルの場合、返される値はミリ秒単位で指定されます。再生オフセットの値は、ユーザーがメディアデバイス上でファイルの再生を開始しても、アプリケーションが IWMDMDeviceControl::Play メソッドを呼び出しても変化しません。

再生可能なファイルを含むフォルダーまたはファイルシステムの場合、返される値は、アプリケーションが IWMDMDeviceControl::Play メソッドを呼び出したときに最初に再生されるトラックを示します。

vtbl 6 HRESULT SetPlayOffset(DWORD dwOffset)

SetPlayOffset メソッドは、オブジェクトの再生オフセットを、フォーマットに応じた単位で設定します。これは次回 Play を呼び出したときの開始位置を指定します。

dwOffset

DWORD

再生オフセットをフォーマットに応じた単位で示す DWORD。

戻り値

標準的な COM エラーコード
HRESULT 値に変換された Windows エラーコード
Windows Media Device Manager のエラーコード

発生しうるエラーコードの詳細な一覧については、Error Codes を参照してください。

解説(Remarks)

渡された値がオブジェクトの総再生長から現在の再生長を引いた値より大きい場合、その値はオブジェクトの長さから再生長を引いた値に丸められます。

再生可能なファイルの場合、値はミリ秒単位で指定します。再生オフセット位置の値は、ユーザーがメディアデバイス上でファイルの再生を開始しても、アプリケーションが IWMDMDeviceControl::Play メソッドを呼び出しても変化しません。

再生可能なファイルを含むフォルダーまたはファイルシステムの場合、この値は、アプリケーションが IWMDMDeviceControl::Play メソッドを呼び出したときに最初に再生されるトラックを示します。

vtbl 7 HRESULT GetTotalLength(DWORD* pdwLength)

GetTotalLength メソッドは、オブジェクトの総再生長を、フォーマットに応じた単位で取得します。返される値は、現在の再生長やオフセットの設定にかかわらず、総再生長になります。

pdwLength

DWORD*

out

ファイルの総再生長を、フォーマットに応じた単位で示す DWORD へのポインター。

戻り値

標準的な COM エラーコード
HRESULT 値に変換された Windows エラーコード
Windows Media Device Manager のエラーコード

発生しうるエラーコードの詳細な一覧については、Error Codes を参照してください。

解説(Remarks)

再生可能なファイルの場合、総再生長はミリ秒単位で指定されます。

再生可能なファイルを含むフォルダーまたはファイルシステムの場合、返される値は、そのフォルダー内またはファイルシステムのルートにある再生可能なファイルの総数を示します。

vtbl 8 HRESULT GetLastPlayPosition(DWORD* pdwLastPos)

GetLastPlayPosition メソッドは、オブジェクトの最後の再生位置を取得します。オブジェクトはメディアデバイス上のオーディオファイルである必要があります。

pdwLastPos

DWORD*

out

オブジェクトの最後の再生位置をミリ秒単位で示す DWORD へのポインター。

戻り値

標準的な COM エラーコード
HRESULT 値に変換された Windows エラーコード
Windows Media Device Manager のエラーコード

発生しうるエラーコードの詳細な一覧については、Error Codes を参照してください。

解説(Remarks)

オブジェクトはオーディオデータファイルである必要があります。それ以外の種類のオブジェクトに対しては、この関数は E_INVALIDTYPE を返します。

最後の再生位置は、ユーザーがメディアデバイス上でファイルの再生を開始したとき、またはアプリケーションが IWMDMDeviceControl::Play メソッドを呼び出したときに変化します。

vtbl 9 HRESULT GetLongestPlayPosition(DWORD* pdwLongestPos)

GetLongestPlayPosition メソッドは、ファイルの最長再生位置を取得します。ファイルはメディアデバイス上のオーディオファイルである必要があります。

pdwLongestPos

DWORD*

out

オブジェクトの最長再生位置をミリ秒単位で示す DWORD へのポインター。

戻り値

標準的な COM エラーコード
HRESULT 値に変換された Windows エラーコード
Windows Media Device Manager のエラーコード

発生しうるエラーコードの詳細な一覧については、Error Codes を参照してください。

解説(Remarks)

オブジェクトはオーディオデータファイルである必要があります。それ以外の種類のオブジェクトに対しては、この関数は E_INVALIDTYPE を返します。

最後の再生位置は、ユーザーがメディアデバイス上でファイルの再生を開始したとき、またはアプリケーションが IWMDMDeviceControl::Play メソッドを呼び出し、その再生がそれまでの最長再生位置を超えたときに変化します。

出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)

HSP用 COM定義

#usecom / #comfunc によるHSPのCOM呼び出し定義。数字は vtbl インデックス(0始まり)。クラスIDが無い場合 #usecom の末尾は "{}"、ある場合は "{CLSID}"。

出力引数:

#define global IID_IWMDMObjectInfo "{1DCB3A09-33ED-11D3-8470-00C04F79DBC0}"
#usecom global IWMDMObjectInfo IID_IWMDMObjectInfo "{}"
#comfunc global IWMDMObjectInfo_GetPlayLength           3 var
#comfunc global IWMDMObjectInfo_SetPlayLength           4 int
#comfunc global IWMDMObjectInfo_GetPlayOffset           5 var
#comfunc global IWMDMObjectInfo_SetPlayOffset           6 int
#comfunc global IWMDMObjectInfo_GetTotalLength          7 var
#comfunc global IWMDMObjectInfo_GetLastPlayPosition     8 var
#comfunc global IWMDMObjectInfo_GetLongestPlayPosition  9 var
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。#define global IID_IWMDMObjectInfo "{1DCB3A09-33ED-11D3-8470-00C04F79DBC0}"
#usecom global IWMDMObjectInfo IID_IWMDMObjectInfo "{}"
#comfunc global IWMDMObjectInfo_GetPlayLength           3 sptr
#comfunc global IWMDMObjectInfo_SetPlayLength           4 int
#comfunc global IWMDMObjectInfo_GetPlayOffset           5 sptr
#comfunc global IWMDMObjectInfo_SetPlayOffset           6 int
#comfunc global IWMDMObjectInfo_GetTotalLength          7 sptr
#comfunc global IWMDMObjectInfo_GetLastPlayPosition     8 sptr
#comfunc global IWMDMObjectInfo_GetLongestPlayPosition  9 sptr
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※出力/バッファ引数はポインタ方式(token=sptr / 呼び出しは varptr(変数))。