IPortableDeviceDispatchFactory
COM公式ドキュメント
WPD Automation の Device オブジェクトを生成できるファクトリを表します。
解説(Remarks)
IPortableDeviceDispatchFactory インターフェイスは、次のコードのように CLSID_PortableDeviceDispatchFactory を使用して直接 CoCreate できます。
IPortableDeviceDispatchFactgory* pDeviceDispatchFactory = NULL;
HRESULT hr = CoCreateInstance(CLSID_PortableDeviceDispatchFactory, NULL, CLSCTX_INPROC_SERVER, IID_PPV_ARGS(&pDeviceDispatchFactory));
例
IPortableDeviceDispatchFactory インターフェイスを使用して WPD Automation の Device オブジェクトを生成する例については、 Instantiating the WPD Automation Factory Interface を参照してください。
メソッド 1
vtbl = vtable インデックス(0始まり)。HSP等からCOMメソッドをインデックス指定で呼ぶ際に使用します。0〜2 は IUnknown。
指定された WPD デバイス識別子に対応する WPD Automation の Device オブジェクトを生成します。(IPortableDeviceDispatchFactory.GetDeviceDispatch)
| pszPnPDeviceID | LPWSTR | in | 現在接続されている WPD デバイスをプラグ アンド プレイが識別するために使用する String へのポインターです。特定のデバイスのプラグ アンド プレイ (PnP) 識別子は、WPD C++/COM API の IPortableDeviceManager::GetDevices メソッドから取得できます。 |
| ppDeviceDispatch | IDispatch** | out | WPD Automation の Device オブジェクトの IDispatch 実装へのポインターを格納します。 |
戻り値
戻り値には、次の表に示す値が含まれます (ただし、これらに限定されません)。
| 戻り値 | 説明 |
|---|---|
| メソッドは成功しました。 |
解説(Remarks)
GetDeviceDispatch メソッドを使用して WPD Automation の Device オブジェクトを生成する例については、 Instantiating the WPD Automation Factory Interface を参照してください。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)
HSP用 COM定義
#usecom / #comfunc によるHSPのCOM呼び出し定義。数字は vtbl インデックス(0始まり)。クラスIDが無い場合 #usecom の末尾は "{}"、ある場合は "{CLSID}"。
#define global IID_IPortableDeviceDispatchFactory "{5E1EAFC3-E3D7-4132-96FA-759C0F9D1E0F}"
#usecom global IPortableDeviceDispatchFactory IID_IPortableDeviceDispatchFactory "{43232233-8338-4658-AE01-0B4AE830B6B0}"
#comfunc global IPortableDeviceDispatchFactory_GetDeviceDispatch 3 wstr,sptr
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※#usecom 末尾は CoCreateInstance 用のクラスID(コクラスCLSID, SDKから自動取得)。
; ※ハンドル/void*等の不透明ポインタは IronHSP では intptr 指定が可能。