Win32 API 日本語リファレンス
ホームDevices.Enumeration.Pnp › IUPnPDevice

IUPnPDevice

COMIDispatch (デュアル)
IDispatch を実装(デュアルインターフェース)。HSP では comobj 経由でメソッド名による遅延バインド呼び出しができます(vtableインデックス不要)。
IID3d44d0d1-98c9-4889-acd1-f9d674bf2221継承元IDispatch呼び出し名前(IDispatch) または vtbl自前メソッド開始 vtbl7

メソッド 19

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

vtbl 7 HRESULT get_IsRootDevice(VARIANT_BOOL* pvarb)
pvarbVARIANT_BOOL*outルートデバイスか否かをVARIANT_BOOLで受け取る出力先。
vtbl 8 HRESULT get_RootDevice(IUPnPDevice** ppudRootDevice)
ppudRootDeviceIUPnPDevice**outこのデバイスが属するルートデバイスを受け取る出力先。
vtbl 9 HRESULT get_ParentDevice(IUPnPDevice** ppudDeviceParent)
ppudDeviceParentIUPnPDevice**out親デバイスを受け取る出力先。ルートの場合はNULLとなる。
vtbl 10 HRESULT get_HasChildren(VARIANT_BOOL* pvarb)
pvarbVARIANT_BOOL*out子デバイスを持つか否かをVARIANT_BOOLで受け取る出力先。
vtbl 11 HRESULT get_Children(IUPnPDevices** ppudChildren)
ppudChildrenIUPnPDevices**out子デバイスのコレクションIUPnPDevicesを受け取る出力先。
vtbl 12 HRESULT get_UniqueDeviceName(LPWSTR* pbstr)
pbstrLPWSTR*outデバイスの一意デバイス名(UDN)を受け取るBSTR出力先。
vtbl 13 HRESULT get_FriendlyName(LPWSTR* pbstr)
pbstrLPWSTR*outユーザーに表示するフレンドリ名を受け取るBSTR出力先。
vtbl 14 HRESULT get_Type(LPWSTR* pbstr)
pbstrLPWSTR*outデバイスタイプ識別子URIを受け取るBSTR出力先。
vtbl 15 HRESULT get_PresentationURL(LPWSTR* pbstr)
pbstrLPWSTR*outデバイス管理ページのプレゼンテーションURLを受け取るBSTR出力先。
vtbl 16 HRESULT get_ManufacturerName(LPWSTR* pbstr)
pbstrLPWSTR*out製造元名を受け取るBSTR出力先。
vtbl 17 HRESULT get_ManufacturerURL(LPWSTR* pbstr)
pbstrLPWSTR*out製造元WebサイトのURLを受け取るBSTR出力先。
vtbl 18 HRESULT get_ModelName(LPWSTR* pbstr)
pbstrLPWSTR*outモデル名を受け取るBSTR出力先。
vtbl 19 HRESULT get_ModelNumber(LPWSTR* pbstr)
pbstrLPWSTR*outモデル番号を受け取るBSTR出力先。
vtbl 20 HRESULT get_Description(LPWSTR* pbstr)
pbstrLPWSTR*outデバイスの説明文を受け取るBSTR出力先。
vtbl 21 HRESULT get_ModelURL(LPWSTR* pbstr)
pbstrLPWSTR*outモデル情報ページのURLを受け取るBSTR出力先。
vtbl 22 HRESULT get_UPC(LPWSTR* pbstr)
pbstrLPWSTR*out製品のUPC(統一商品コード)を受け取るBSTR出力先。
vtbl 23 HRESULT get_SerialNumber(LPWSTR* pbstr)
pbstrLPWSTR*outデバイスのシリアル番号を受け取るBSTR出力先。
vtbl 24 HRESULT IconURL(LPWSTR bstrEncodingFormat, INT lSizeX, INT lSizeY, INT lBitDepth, LPWSTR* pbstrIconURL)
bstrEncodingFormatLPWSTRin希望するアイコンのMIME画像形式(例: image/png)。
lSizeXINTin希望するアイコンの横ピクセル幅。
lSizeYINTin希望するアイコンの縦ピクセル高さ。
lBitDepthINTin希望するアイコンの色ビット深度。
pbstrIconURLLPWSTR*out条件に最も近いアイコンのURLを受け取るBSTR出力先。
vtbl 25 HRESULT get_Services(IUPnPServices** ppusServices)
ppusServicesIUPnPServices**outこのデバイスのサービスコレクションIUPnPServicesを受け取る出力先。

HSP用 COM定義

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

出力引数:
#define global IID_IUPnPDevice "{3D44D0D1-98C9-4889-ACD1-F9D674BF2221}"
#usecom global IUPnPDevice IID_IUPnPDevice "{}"
#comfunc global IUPnPDevice_get_IsRootDevice      7 var
#comfunc global IUPnPDevice_get_RootDevice        8 sptr
#comfunc global IUPnPDevice_get_ParentDevice      9 sptr
#comfunc global IUPnPDevice_get_HasChildren       10 var
#comfunc global IUPnPDevice_get_Children          11 sptr
#comfunc global IUPnPDevice_get_UniqueDeviceName  12 var
#comfunc global IUPnPDevice_get_FriendlyName      13 var
#comfunc global IUPnPDevice_get_Type              14 var
#comfunc global IUPnPDevice_get_PresentationURL   15 var
#comfunc global IUPnPDevice_get_ManufacturerName  16 var
#comfunc global IUPnPDevice_get_ManufacturerURL   17 var
#comfunc global IUPnPDevice_get_ModelName         18 var
#comfunc global IUPnPDevice_get_ModelNumber       19 var
#comfunc global IUPnPDevice_get_Description       20 var
#comfunc global IUPnPDevice_get_ModelURL          21 var
#comfunc global IUPnPDevice_get_UPC               22 var
#comfunc global IUPnPDevice_get_SerialNumber      23 var
#comfunc global IUPnPDevice_IconURL               24 wstr,int,int,int,var
#comfunc global IUPnPDevice_get_Services          25 sptr
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。
; ※ハンドル/void*等の不透明ポインタは IronHSP では intptr 指定が可能。
; ※IDispatch 実装。HSP では comobj 経由でメソッド名による呼び出しも可能(vtbl 不要)。