Win32 API 日本語リファレンス
ホーム › Media.DeviceManager › IWMDMOperation

IWMDMOperation

COM
📘 Microsoft Learn (日本語) · English
IID1dcb3a0b-33ed-11d3-8470-00c04f79dbc0継承元IUnknown自前メソッド開始 vtbl3

メソッド 10

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

vtbl 3 HRESULT BeginRead()
vtbl 4 HRESULT BeginWrite()
vtbl 5 HRESULT GetObjectName(LPWSTR pwszName, DWORD nMaxChars)
pwszNameLPWSTRoutオブジェクト名を受け取るワイド文字列バッファーへのポインター。
nMaxCharsDWORDinバッファーが格納できる最大文字数を示すDWORD値。
vtbl 6 HRESULT SetObjectName(LPWSTR pwszName, DWORD nMaxChars)
pwszNameLPWSTRin設定するオブジェクト名を表すワイド文字列。
nMaxCharsDWORDin名前の文字数を示すDWORD値。
vtbl 7 HRESULT GetObjectAttributes(DWORD* pdwAttributes, WAVEFORMATEX* pFormat)
pdwAttributesDWORD*outオブジェクトの属性ビットマスクを受け取るDWORDへの出力ポインター。
pFormatWAVEFORMATEX*inoutoptionalオブジェクトのオーディオ形式を受け取るWAVEFORMATEXへのポインター。不要ならNULL可。
vtbl 8 HRESULT SetObjectAttributes(DWORD dwAttributes, WAVEFORMATEX* pFormat)
dwAttributesDWORDin設定するオブジェクト属性を示すビットマスク。
pFormatWAVEFORMATEX*inoptional設定するオーディオ形式を記述するWAVEFORMATEXへのポインター。不要ならNULL可。
vtbl 9 HRESULT GetObjectTotalSize(DWORD* pdwSize, DWORD* pdwSizeHigh)
pdwSizeDWORD*outオブジェクト総サイズの下位32ビットをバイト単位で受け取るDWORDへの出力ポインター。
pdwSizeHighDWORD*outオブジェクト総サイズの上位32ビットをバイト単位で受け取るDWORDへの出力ポインター。
vtbl 10 HRESULT SetObjectTotalSize(DWORD dwSize, DWORD dwSizeHigh)
dwSizeDWORDinオブジェクト総サイズの下位32ビットをバイト単位で指定するDWORD値。
dwSizeHighDWORDinオブジェクト総サイズの上位32ビットをバイト単位で指定するDWORD値。
vtbl 11 HRESULT TransferObjectData(BYTE* pData, DWORD* pdwSize, BYTE* abMac)
pDataBYTE*inout転送するデータチャンクを保持するバイトバッファーへのポインター。
pdwSizeDWORD*inout入力時はバッファーサイズ、出力時は実際に転送されたバイト数を保持するDWORDへのポインター。
abMacBYTE*inout改ざん検出用のメッセージ認証コード（MAC）を格納するバイト配列。
vtbl 12 HRESULT End(HRESULT* phCompletionCode, IUnknown* pNewObject)
phCompletionCodeHRESULT*in操作完了コードを示すHRESULTへのポインター。
pNewObjectIUnknown*inoptional新規生成されたオブジェクトを表すIUnknownへのポインター。不要ならNULL可。

HSP用 COM定義

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

出力引数: 
#define global IID_IWMDMOperation "{1DCB3A0B-33ED-11D3-8470-00C04F79DBC0}"
#usecom global IWMDMOperation IID_IWMDMOperation "{}"
#comfunc global IWMDMOperation_BeginRead            3
#comfunc global IWMDMOperation_BeginWrite           4
#comfunc global IWMDMOperation_GetObjectName        5 var,int
#comfunc global IWMDMOperation_SetObjectName        6 wstr,int
#comfunc global IWMDMOperation_GetObjectAttributes  7 var,var
#comfunc global IWMDMOperation_SetObjectAttributes  8 int,var
#comfunc global IWMDMOperation_GetObjectTotalSize   9 var,var
#comfunc global IWMDMOperation_SetObjectTotalSize   10 int,int
#comfunc global IWMDMOperation_TransferObjectData   11 var,var,var
#comfunc global IWMDMOperation_End                  12 var,sptr
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。
; ※ハンドル/void*等の不透明ポインタは IronHSP では intptr 指定が可能。