Win32 API 日本語リファレンス
ホームDevices.PortableDevices › IPortableDeviceEventCallback

IPortableDeviceEventCallback

COM
IIDa8792a31-f385-493c-a893-40f64eb45f6e継承元IUnknown自前メソッド開始 vtbl3

公式ドキュメント

IPortableDeviceEventCallback インターフェイスは、アプリケーションが IPortableDevice::Advise を呼び出して非同期コールバックの受信を登録した場合に、それらを受け取るためにアプリケーション側で実装するインターフェイスです。

メソッド 1

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

vtbl 3 HRESULT OnEvent(IPortableDeviceValues* pEventParameters)

OnEvent メソッドは、非同期イベントをアプリケーションに通知するために SDK から呼び出されます。

pEventParametersIPortableDeviceValues*inイベントの詳細情報を格納する IPortableDeviceValues インターフェイスへのポインターです。

戻り値

アプリケーションが返す値は、Windows Portable Devices によって無視されます。

解説(Remarks)

アプリケーションは、IPortableDevice::Advise を呼び出してイベントの受信を登録する必要があります。

このメソッドの使用例については、Handling Events from the Device を参照してください。

出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)

HSP用 COM定義

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

#define global IID_IPortableDeviceEventCallback "{A8792A31-F385-493C-A893-40F64EB45F6E}"
#usecom global IPortableDeviceEventCallback IID_IPortableDeviceEventCallback "{}"
#comfunc global IPortableDeviceEventCallback_OnEvent  3 sptr
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※ハンドル/void*等の不透明ポインタは IronHSP では intptr 指定が可能。