ホーム › NetworkManagement.MobileBroadband › IMbnDeviceServicesEvents
IMbnDeviceServicesEvents
COM公式ドキュメント
システム上のモバイルブロードバンドのデバイスサービスに関連する通知イベントをアプリケーションに通知します。
解説(Remarks)
通知を登録する手順は次のとおりです。
- IMbnDeviceServicesManager オブジェクトで QueryInterface を呼び出して IConnectionPoint インターフェイスを取得します。
- 返されたインターフェイスで FindConnectionPoint を呼び出し、RIID に IID_IMbnDeviceServicesEvents を渡します。
- 返された接続ポイントで Advise を呼び出し、IMbnDeviceServicesEvents を実装するオブジェクトの IUnknown インターフェイスへのポインターを PUNK に渡します。
通知は、手順 2 で返された接続ポイントで Unadvise を呼び出すことで終了できます。
COM 通知を登録するコードの例については、COM Connection Points の記事の Client セクションを参照してください。
メソッド 11
vtbl = vtable インデックス(0始まり)。HSP等からCOMメソッドをインデックス指定で呼ぶ際に使用します。0〜2 は IUnknown。
vtbl 3 HRESULT OnQuerySupportedCommandsComplete(IMbnDeviceService* deviceService, SAFEARRAY* commandIDList, HRESULT status, DWORD requestID)
デバイスサービスでサポートされるメッセージのクエリが完了したことを示す通知メソッドです。
| deviceService | IMbnDeviceService* | in | クエリが要求された IMbnDeviceService オブジェクトです。 |
| commandIDList | SAFEARRAY* | in | デバイスサービスでサポートされるコマンド ID のリストを格納する配列です。このフィールドは status が S_OK の場合にのみ有効です。 |
| status | HRESULT | in | 操作の結果を示すステータスコードです。 |
| requestID | DWORD | in | モバイルブロードバンドサービスがクエリ操作の要求に割り当てたリクエスト ID です。 |
戻り値
このメソッドは次の値を返す必要があります。
| リターンコード | 説明 |
|---|---|
| メソッドは正常に完了しました。 |
解説(Remarks)
モバイルブロードバンドサービスは、関数呼び出しが戻った後に commandIDList のメモリを解放します。アプリケーションがこのデータを使用する場合は、その内容を独自のメモリにコピーする必要があります。
vtbl 4 HRESULT OnOpenCommandSessionComplete(IMbnDeviceService* deviceService, HRESULT status, DWORD requestID)
デバイスサービスの CommandSessionOpen 要求が完了したことを示す通知メソッドです。
| deviceService | IMbnDeviceService* | in | CommandSessionOpen が要求された IMbnDeviceService オブジェクトです。 |
| status | HRESULT | in | 操作の結果を示すステータスコードです。 |
| requestID | DWORD | in | モバイルブロードバンドサービスが CommandSessionOpen 要求に割り当てたリクエスト ID です。 |
戻り値
このメソッドは次の値を返す必要があります。
| リターンコード | 説明 |
|---|---|
| メソッドは正常に完了しました。 |
vtbl 5 HRESULT OnCloseCommandSessionComplete(IMbnDeviceService* deviceService, HRESULT status, DWORD requestID)
デバイスサービスの CloseCommandSession 要求が完了したことを示す通知メソッドです。
| deviceService | IMbnDeviceService* | in | CloseCommandSession が要求された IMbnDeviceService オブジェクトです。 |
| status | HRESULT | in | 操作の結果を示すステータスコードです。 |
| requestID | DWORD | in | モバイルブロードバンドサービスがクローズ要求に割り当てたリクエスト ID です。 |
戻り値
このメソッドは次の値を返す必要があります。
| リターンコード | 説明 |
|---|---|
| メソッドは正常に完了しました。 |
vtbl 6 HRESULT OnSetCommandComplete(IMbnDeviceService* deviceService, DWORD responseID, SAFEARRAY* deviceServiceData, HRESULT status, DWORD requestID)
デバイスサービスの SET 要求が完了したことを示す通知メソッドです。
| deviceService | IMbnDeviceService* | in | 操作が要求された IMbnDeviceService オブジェクトです。 |
| responseID | DWORD | in | 応答の識別子です。 |
| deviceServiceData | SAFEARRAY* | in | デバイスから返されたデータを格納するバイト配列です。応答が複数のインジケーションに分割されている場合、これには 1 つのフラグメントの情報のみが格納されます。このフィールドは status が S_OK の場合にのみ有効です。 |
| status | HRESULT | in | 操作の結果を示すステータスコードです。 |
| requestID | DWORD | in | モバイルブロードバンドサービスが set 操作の要求に割り当てたリクエスト ID です。 |
戻り値
このメソッドは次の値を返す必要があります。
| リターンコード | 説明 |
|---|---|
| メソッドは正常に完了しました。 |
解説(Remarks)
deviceServiceData バイト配列には、デバイスから返されたデータのバイト単位のコピーが格納されます。モバイルブロードバンドサービスは、関数呼び出しが戻った後にメモリを解放します。アプリケーションがこのデータを使用する場合は、その内容を独自のメモリにコピーする必要があります。
vtbl 7 HRESULT OnQueryCommandComplete(IMbnDeviceService* deviceService, DWORD responseID, SAFEARRAY* deviceServiceData, HRESULT status, DWORD requestID)
デバイスサービスの QUERY 要求が完了したことを示す通知メソッドです。
| deviceService | IMbnDeviceService* | in | 操作が要求された IMbnDeviceService オブジェクトです。 |
| responseID | DWORD | in | 応答の識別子です。 |
| deviceServiceData | SAFEARRAY* | in | デバイスから返されたデータを格納するバイト配列です。応答が複数のインジケーションに分割されている場合、これには 1 つのフラグメントの情報のみが格納されます。このフィールドは status が S_OK の場合にのみ有効です。 |
| status | HRESULT | in | 操作の結果を示すステータスコードです。 |
| requestID | DWORD | in | モバイルブロードバンドサービスがクエリ操作の要求に割り当てたリクエスト ID です。 |
戻り値
このメソッドは次の値を返す必要があります。
| リターンコード | 説明 |
|---|---|
| メソッドは正常に完了しました。 |
解説(Remarks)
deviceServiceData バイト配列には、デバイスから返されたデータのバイト単位のコピーが格納されます。モバイルブロードバンドサービスは、関数呼び出しが戻った後にメモリを解放します。アプリケーションがこのデータを使用する場合は、その内容を独自のメモリにコピーする必要があります。
vtbl 8 HRESULT OnEventNotification(IMbnDeviceService* deviceService, DWORD eventID, SAFEARRAY* deviceServiceData)
モバイルブロードバンドデバイスからのデバイスサービスの状態変更イベントを通知するメソッドです。
| deviceService | IMbnDeviceService* | in | イベント通知を受信した IMbnDeviceService オブジェクトです。 |
| eventID | DWORD | in | イベントの識別子です。 |
| deviceServiceData | SAFEARRAY* | in | 基になるデバイスから返されたデータを格納するバイト配列です。 |
戻り値
このメソッドは次の値を返す必要があります。
| リターンコード | 説明 |
|---|---|
| メソッドは正常に完了しました。 |
解説(Remarks)
deviceServiceData バイト配列には、デバイスから返されたデータのバイト単位のコピーが格納されます。モバイルブロードバンドサービスは、関数呼び出しが戻った後にメモリを解放します。アプリケーションがこのデータを使用する場合は、その内容を独自のメモリにコピーする必要があります。
vtbl 9 HRESULT OnOpenDataSessionComplete(IMbnDeviceService* deviceService, HRESULT status, DWORD requestID)
デバイスサービスの OpenDataSession 要求が完了したことを示す通知メソッドです。
| deviceService | IMbnDeviceService* | in | OpenDataSession が要求された IMbnDeviceService オブジェクトです。 |
| status | HRESULT | in | 操作の結果を示すステータスコードです。 |
| requestID | DWORD | in | モバイルブロードバンドサービスが OpenDataSession 要求に割り当てたリクエスト ID です。 |
戻り値
このメソッドは次の値を返す必要があります。
| リターンコード | 説明 |
|---|---|
| メソッドは正常に完了しました。 |
vtbl 10 HRESULT OnCloseDataSessionComplete(IMbnDeviceService* deviceService, HRESULT status, DWORD requestID)
デバイスサービスセッションの CloseDataSession 要求が完了したことを示す通知メソッドです。
| deviceService | IMbnDeviceService* | in | CloseDataSession が要求された IMbnDeviceService セッションオブジェクトです。 |
| status | HRESULT | in | 操作の結果を示すステータスコードです。 |
| requestID | DWORD | in | モバイルブロードバンドサービスが CloseDataSession 要求に割り当てたリクエスト ID です。 |
戻り値
このメソッドは次の値を返す必要があります。
| リターンコード | 説明 |
|---|---|
| メソッドは正常に完了しました。 |
vtbl 11 HRESULT OnWriteDataComplete(IMbnDeviceService* deviceService, HRESULT status, DWORD requestID)
デバイスサービスセッションの Write 要求が完了したことを示す通知メソッドです。
| deviceService | IMbnDeviceService* | in | Write が要求された IMbnDeviceService セッションオブジェクトです。 |
| status | HRESULT | in | 操作の結果を示すステータスコードです。 |
| requestID | DWORD | in | モバイルブロードバンドサービスが Write 要求に割り当てたリクエスト ID です。 |
戻り値
このメソッドは次の値を返す必要があります。
| リターンコード | 説明 |
|---|---|
| メソッドは正常に完了しました。 |
vtbl 12 HRESULT OnReadData(IMbnDeviceService* deviceService, SAFEARRAY* deviceServiceData)
デバイスサービスのデータセッションから読み取られたデータの通知です。
| deviceService | IMbnDeviceService* | in | データが読み取られた IMbnDeviceService セッションオブジェクトです。 |
| deviceServiceData | SAFEARRAY* | in | 基になるデバイスサービスセッションから読み取られたデータを格納するバイト配列です。 |
戻り値
このメソッドは次の値を返す必要があります。
| リターンコード | 説明 |
|---|---|
| メソッドは正常に完了しました。 |
解説(Remarks)
このバイト配列には、デバイスサービスセッションから読み取られたデータのバイト単位のコピーが格納されます。モバイルブロードバンドサービスは、関数呼び出しが戻った後にこのフィールドのメモリを解放します。アプリケーションがこのデータを使用する場合は、その内容を独自のメモリにコピーする必要があります。
vtbl 13 HRESULT OnInterfaceStateChange(LPWSTR interfaceID, MBN_DEVICE_SERVICES_INTERFACE_STATE stateChange)
システム上のデバイスサービスの状態の変化を通知するメソッドです。
| interfaceID | LPWSTR | in | デバイスサービスの状態変更通知が送信されるデバイスの InterfaceID です。 |
| stateChange | MBN_DEVICE_SERVICES_INTERFACE_STATE | in | デバイスサービス対応デバイスが利用可能か利用不可かを指定する MBN_DEVICE_SERVICES_INTERFACE_STATE 列挙型です。 |
戻り値
このメソッドは次の値を返す必要があります。
| リターンコード | 説明 |
|---|---|
| メソッドは正常に完了しました。 |
出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)
HSP用 COM定義
#usecom / #comfunc によるHSPのCOM呼び出し定義。数字は vtbl インデックス(0始まり)。クラスIDが無い場合 #usecom の末尾は "{}"、ある場合は "{CLSID}"。
出力引数:
#define global IID_IMbnDeviceServicesEvents "{0A900C19-6824-4E97-B76E-CF239D0CA642}" #usecom global IMbnDeviceServicesEvents IID_IMbnDeviceServicesEvents "{}" #comfunc global IMbnDeviceServicesEvents_OnQuerySupportedCommandsComplete 3 sptr,var,int,int #comfunc global IMbnDeviceServicesEvents_OnOpenCommandSessionComplete 4 sptr,int,int #comfunc global IMbnDeviceServicesEvents_OnCloseCommandSessionComplete 5 sptr,int,int #comfunc global IMbnDeviceServicesEvents_OnSetCommandComplete 6 sptr,int,var,int,int #comfunc global IMbnDeviceServicesEvents_OnQueryCommandComplete 7 sptr,int,var,int,int #comfunc global IMbnDeviceServicesEvents_OnEventNotification 8 sptr,int,var #comfunc global IMbnDeviceServicesEvents_OnOpenDataSessionComplete 9 sptr,int,int #comfunc global IMbnDeviceServicesEvents_OnCloseDataSessionComplete 10 sptr,int,int #comfunc global IMbnDeviceServicesEvents_OnWriteDataComplete 11 sptr,int,int #comfunc global IMbnDeviceServicesEvents_OnReadData 12 sptr,var #comfunc global IMbnDeviceServicesEvents_OnInterfaceStateChange 13 wstr,int ; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。 ; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。 ; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。 ; ※ハンドル/void*等の不透明ポインタは IronHSP では intptr 指定が可能。#define global IID_IMbnDeviceServicesEvents "{0A900C19-6824-4E97-B76E-CF239D0CA642}" #usecom global IMbnDeviceServicesEvents IID_IMbnDeviceServicesEvents "{}" #comfunc global IMbnDeviceServicesEvents_OnQuerySupportedCommandsComplete 3 sptr,sptr,int,int #comfunc global IMbnDeviceServicesEvents_OnOpenCommandSessionComplete 4 sptr,int,int #comfunc global IMbnDeviceServicesEvents_OnCloseCommandSessionComplete 5 sptr,int,int #comfunc global IMbnDeviceServicesEvents_OnSetCommandComplete 6 sptr,int,sptr,int,int #comfunc global IMbnDeviceServicesEvents_OnQueryCommandComplete 7 sptr,int,sptr,int,int #comfunc global IMbnDeviceServicesEvents_OnEventNotification 8 sptr,int,sptr #comfunc global IMbnDeviceServicesEvents_OnOpenDataSessionComplete 9 sptr,int,int #comfunc global IMbnDeviceServicesEvents_OnCloseDataSessionComplete 10 sptr,int,int #comfunc global IMbnDeviceServicesEvents_OnWriteDataComplete 11 sptr,int,int #comfunc global IMbnDeviceServicesEvents_OnReadData 12 sptr,sptr #comfunc global IMbnDeviceServicesEvents_OnInterfaceStateChange 13 wstr,int ; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。 ; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。 ; ※出力/バッファ引数はポインタ方式(token=sptr / 呼び出しは varptr(変数))。 ; ※ハンドル/void*等の不透明ポインタは IronHSP では intptr 指定が可能。