Win32 API 日本語リファレンス
ホーム › NetworkManagement.MobileBroadband › IMbnDeviceService

IMbnDeviceService

COM
📘 Microsoft Learn (日本語) · English
IIDb3bb9a71-dc70-4be9-a4da-7886ae8b191b継承元IUnknown自前メソッド開始 vtbl3

メソッド 12

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

vtbl 3 HRESULT QuerySupportedCommands(DWORD* requestID)
requestIDDWORD*outサポートコマンド照会の非同期要求を識別するIDを受け取る出力ポインタ。完了イベントで照合する。
vtbl 4 HRESULT OpenCommandSession(DWORD* requestID)
requestIDDWORD*outコマンドセッション開始の非同期要求を識別するIDを受け取る出力ポインタ。完了イベントで照合する。
vtbl 5 HRESULT CloseCommandSession(DWORD* requestID)
requestIDDWORD*outコマンドセッション終了の非同期要求を識別するIDを受け取る出力ポインタ。完了イベントで照合する。
vtbl 6 HRESULT SetCommand(DWORD commandID, SAFEARRAY* deviceServiceData, DWORD* requestID)
commandIDDWORDin送信するSetコマンドの種類を識別するコマンドIDの入力。
deviceServiceDataSAFEARRAY*inSetコマンドで送信するデータをSAFEARRAYで指定する入力。
requestIDDWORD*out非同期送信要求を識別するIDを受け取る出力ポインタ。完了イベントで照合する。
vtbl 7 HRESULT QueryCommand(DWORD commandID, SAFEARRAY* deviceServiceData, DWORD* requestID)
commandIDDWORDin送信するQueryコマンドの種類を識別するコマンドIDの入力。
deviceServiceDataSAFEARRAY*inQueryコマンドに付随する送信データをSAFEARRAYで指定する入力。
requestIDDWORD*out非同期照会要求を識別するIDを受け取る出力ポインタ。完了イベントで照合する。
vtbl 8 HRESULT OpenDataSession(DWORD* requestID)
requestIDDWORD*outデータセッション開始の非同期要求を識別するIDを受け取る出力ポインタ。完了イベントで照合する。
vtbl 9 HRESULT CloseDataSession(DWORD* requestID)
requestIDDWORD*outデータセッション終了の非同期要求を識別するIDを受け取る出力ポインタ。完了イベントで照合する。
vtbl 10 HRESULT WriteData(SAFEARRAY* deviceServiceData, DWORD* requestID)
deviceServiceDataSAFEARRAY*inデータセッションで書き込むデータをSAFEARRAYで指定する入力。
requestIDDWORD*out非同期書き込み要求を識別するIDを受け取る出力ポインタ。完了イベントで照合する。
vtbl 11 HRESULT get_InterfaceID(LPWSTR* InterfaceID)
InterfaceIDLPWSTR*outこのデバイスサービスが属するインターフェイスのID文字列を受け取る出力ポインタ。呼び出し側が解放する。
vtbl 12 HRESULT get_DeviceServiceID(LPWSTR* DeviceServiceID)
DeviceServiceIDLPWSTR*outこのデバイスサービスを識別するGUID文字列を受け取る出力ポインタ。呼び出し側が解放する。
vtbl 13 HRESULT get_IsCommandSessionOpen(BOOL* value)
valueBOOL*outコマンドセッションが開いているかを示すBOOLを受け取る出力ポインタ。TRUEで開いている。
vtbl 14 HRESULT get_IsDataSessionOpen(BOOL* value)
valueBOOL*outデータセッションが開いているかを示すBOOLを受け取る出力ポインタ。TRUEで開いている。

HSP用 COM定義

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

出力引数: 
#define global IID_IMbnDeviceService "{B3BB9A71-DC70-4BE9-A4DA-7886AE8B191B}"
#usecom global IMbnDeviceService IID_IMbnDeviceService "{}"
#comfunc global IMbnDeviceService_QuerySupportedCommands    3 var
#comfunc global IMbnDeviceService_OpenCommandSession        4 var
#comfunc global IMbnDeviceService_CloseCommandSession       5 var
#comfunc global IMbnDeviceService_SetCommand                6 int,var,var
#comfunc global IMbnDeviceService_QueryCommand              7 int,var,var
#comfunc global IMbnDeviceService_OpenDataSession           8 var
#comfunc global IMbnDeviceService_CloseDataSession          9 var
#comfunc global IMbnDeviceService_WriteData                 10 var,var
#comfunc global IMbnDeviceService_get_InterfaceID           11 var
#comfunc global IMbnDeviceService_get_DeviceServiceID       12 var
#comfunc global IMbnDeviceService_get_IsCommandSessionOpen  13 var
#comfunc global IMbnDeviceService_get_IsDataSessionOpen     14 var
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。