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

IMDSPObject

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

メソッド 8

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

vtbl 3 HRESULT Open(DWORD fuMode)
fuModeDWORDinオブジェクトを開く際のアクセスモードを示すWMDM_MODE系フラグ。読み書き方向等を指定する。
vtbl 4 HRESULT Read(BYTE* pData, DWORD* pdwSize, BYTE* abMac)
pDataBYTE*out読み取ったデータを受け取るバッファ。
pdwSizeDWORD*inout読み取り要求サイズを入力し、実際に読めたバイト数を出力で返す入出力。
abMacBYTE*inoutデータ整合性検証用のMACを受け取るバイト配列。
vtbl 5 HRESULT Write(BYTE* pData, DWORD* pdwSize, BYTE* abMac)
pDataBYTE*in書き込むデータを格納したバッファ。
pdwSizeDWORD*inout書き込み要求サイズを入力し、実際に書けたバイト数を出力で返す入出力。
abMacBYTE*inoutデータ整合性検証用のMACを格納したバイト配列。
vtbl 6 HRESULT Delete(DWORD fuMode, IWMDMProgress* pProgress)
fuModeDWORDin削除動作を制御するフラグ。再帰削除等の挙動を指定する。
pProgressIWMDMProgress*inoptional進捗通知を受け取るIWMDMProgressコールバック。NULL可。
vtbl 7 HRESULT Seek(DWORD fuFlags, DWORD dwOffset)
fuFlagsDWORDinシーク基準を示すWMDM_SEEK系フラグ。先頭/現在/末尾基準を指定する。
dwOffsetDWORDin基準位置からのシーク量をバイト単位で指定する。
vtbl 8 HRESULT Rename(LPWSTR pwszNewName, IWMDMProgress* pProgress)
pwszNewNameLPWSTRinオブジェクトの新しい名前を示す文字列。
pProgressIWMDMProgress*inoptional進捗通知を受け取るIWMDMProgressコールバック。NULL可。
vtbl 9 HRESULT Move(DWORD fuMode, IWMDMProgress* pProgress, IMDSPStorage* pTarget)
fuModeDWORDin移動動作を制御するフラグ。移動方法を指定する。
pProgressIWMDMProgress*inoptional進捗通知を受け取るIWMDMProgressコールバック。NULL可。
pTargetIMDSPStorage*inoptional移動先となるIMDSPStorage。宛先フォルダを示す。
vtbl 10 HRESULT Close()

HSP用 COM定義

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

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