ホーム › Devices.Enumeration.Pnp › IUPnPDeviceFinder

IUPnPDeviceFinder

COMIDispatch (デュアル)

✅ IDispatch を実装(デュアルインターフェース)。HSP では comobj 経由でメソッド名による遅延バインド呼び出しができます(vtableインデックス不要)。

IIDadda3d55-6f72-4319-bff9-18600a539b10継承元IDispatch呼び出し名前(IDispatch) または vtbl自前メソッド開始 vtbl7

メソッド 5

vtbl = vtable インデックス(0始まり)。IDispatch 実装のため HSP ではメソッド名でも呼べます(上記)。低レベルの index 呼び出し用に vtbl も掲載。0〜2 は IUnknown。

vtbl 7 HRESULT FindByType(LPWSTR bstrTypeURI, DWORD dwFlags, IUPnPDevices** pDevices)

bstrTypeURI	LPWSTR	in	検索対象のUPnPデバイス/サービス種別を示すタイプURI。
dwFlags	DWORD	in	検索動作を制御するフラグ(現状予約、通常0)。
pDevices	IUPnPDevices**	out	一致したデバイス群を表すIUPnPDevicesコレクションを受け取る出力先。

vtbl 8 HRESULT CreateAsyncFind(LPWSTR bstrTypeURI, DWORD dwFlags, IUnknown* punkDeviceFinderCallback, INT* plFindData)

bstrTypeURI	LPWSTR	in	非同期検索の対象種別を示すタイプURI。
dwFlags	DWORD	in	検索動作を制御するフラグ(現状予約、通常0)。
punkDeviceFinderCallback	IUnknown*	in	検索イベントを受け取るIUPnPDeviceFinderCallback実装。
plFindData	INT*	out	開始した非同期検索を識別するハンドル(検索データ)を受け取る出力先。

vtbl 9 HRESULT StartAsyncFind(INT lFindData)

lFindData

INT

CreateAsyncFindで取得した非同期検索の識別ハンドル。

vtbl 10 HRESULT CancelAsyncFind(INT lFindData)

lFindData

INT

中止する非同期検索の識別ハンドル。

vtbl 11 HRESULT FindByUDN(LPWSTR bstrUDN, IUPnPDevice** pDevice)

bstrUDN	LPWSTR	in	検索対象デバイスの一意デバイス名(UDN)。
pDevice	IUPnPDevice**	out	UDNに一致したIUPnPDeviceを受け取る出力先。

HSP用 COM定義

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

出力引数:

#define global IID_IUPnPDeviceFinder "{ADDA3D55-6F72-4319-BFF9-18600A539B10}"
#usecom global IUPnPDeviceFinder IID_IUPnPDeviceFinder "{E2085F28-FEB7-404A-B8E7-E659BDEAAA02}"
#comfunc global IUPnPDeviceFinder_FindByType       7 wstr,int,sptr
#comfunc global IUPnPDeviceFinder_CreateAsyncFind  8 wstr,int,sptr,var
#comfunc global IUPnPDeviceFinder_StartAsyncFind   9 int
#comfunc global IUPnPDeviceFinder_CancelAsyncFind  10 int
#comfunc global IUPnPDeviceFinder_FindByUDN        11 wstr,sptr
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※#usecom 末尾は CoCreateInstance 用のクラスID(コクラスCLSID, SDKから自動取得)。
; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。
; ※ハンドル/void*等の不透明ポインタは IronHSP では intptr 指定が可能。
; ※IDispatch 実装。HSP では comobj 経由でメソッド名による呼び出しも可能(vtbl 不要)。#define global IID_IUPnPDeviceFinder "{ADDA3D55-6F72-4319-BFF9-18600A539B10}"
#usecom global IUPnPDeviceFinder IID_IUPnPDeviceFinder "{E2085F28-FEB7-404A-B8E7-E659BDEAAA02}"
#comfunc global IUPnPDeviceFinder_FindByType       7 wstr,int,sptr
#comfunc global IUPnPDeviceFinder_CreateAsyncFind  8 wstr,int,sptr,sptr
#comfunc global IUPnPDeviceFinder_StartAsyncFind   9 int
#comfunc global IUPnPDeviceFinder_CancelAsyncFind  10 int
#comfunc global IUPnPDeviceFinder_FindByUDN        11 wstr,sptr
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※#usecom 末尾は CoCreateInstance 用のクラスID(コクラスCLSID, SDKから自動取得)。
; ※出力/バッファ引数はポインタ方式(token=sptr / 呼び出しは varptr(変数))。
; ※ハンドル/void*等の不透明ポインタは IronHSP では intptr 指定が可能。
; ※IDispatch 実装。HSP では comobj 経由でメソッド名による呼び出しも可能(vtbl 不要)。