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

IMDSPDevice

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

メソッド 11

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

vtbl 3 HRESULT GetName(LPWSTR pwszName, DWORD nMaxChars)
pwszNameLPWSTRoutデバイス名を受け取る出力バッファ。表示用の名称が格納される。
nMaxCharsDWORDinpwszNameバッファの最大文字数。終端を含むサイズを指定する。
vtbl 4 HRESULT GetManufacturer(LPWSTR pwszName, DWORD nMaxChars)
pwszNameLPWSTRout製造元名を受け取る出力バッファ。
nMaxCharsDWORDinpwszNameバッファの最大文字数を指定する。
vtbl 5 HRESULT GetVersion(DWORD* pdwVersion)
pdwVersionDWORD*outデバイスのバージョン番号を受け取る出力。
vtbl 6 HRESULT GetType(DWORD* pdwType)
pdwTypeDWORD*outデバイス種別を示すWMDM_DEVICE_TYPE系フラグを受け取る出力。
vtbl 7 HRESULT GetSerialNumber(WMDMID* pSerialNumber, BYTE* abMac)
pSerialNumberWMDMID*outデバイスのシリアル番号を受け取るWMDMID構造体の出力。
abMacBYTE*inout改ざん検証用のメッセージ認証コード(MAC)を受け取るバイト配列。
vtbl 8 HRESULT GetPowerSource(DWORD* pdwPowerSource, DWORD* pdwPercentRemaining)
pdwPowerSourceDWORD*out電源種別(バッテリ/外部電源)を示すフラグを受け取る出力。
pdwPercentRemainingDWORD*outバッテリ残量をパーセントで受け取る出力。
vtbl 9 HRESULT GetStatus(DWORD* pdwStatus)
pdwStatusDWORD*outデバイスの状態を示すWMDM_STATUS系フラグを受け取る出力。
vtbl 10 HRESULT GetDeviceIcon(DWORD* hIcon)
hIconDWORD*outデバイスアイコンのハンドル(HICON相当)を受け取る出力。
vtbl 11 HRESULT EnumStorage(IMDSPEnumStorage** ppEnumStorage)
ppEnumStorageIMDSPEnumStorage**outデバイス直下のストレージ列挙子IMDSPEnumStorageを受け取る出力。
vtbl 12 HRESULT GetFormatSupport(WAVEFORMATEX** pFormatEx, DWORD* pnFormatCount, LPWSTR** pppwszMimeType, DWORD* pnMimeTypeCount)
pFormatExWAVEFORMATEX**outサポートする音声フォーマットのWAVEFORMATEX配列を受け取る出力。
pnFormatCountDWORD*out音声フォーマット配列の要素数を受け取る出力。
pppwszMimeTypeLPWSTR**outサポートするMIMEタイプ文字列の配列を受け取る出力。
pnMimeTypeCountDWORD*outMIMEタイプ配列の要素数を受け取る出力。
vtbl 13 HRESULT SendOpaqueCommand(OPAQUECOMMAND* pCommand)
pCommandOPAQUECOMMAND*inoutプロバイダ固有のコマンドを受け渡すOPAQUECOMMAND構造体。入出力に使う。

HSP用 COM定義

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

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