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

IWiaItem

COM
📘 Microsoft Learn (日本語) · English
IID4db1ad10-3391-11d2-9a33-00c04fa36145継承元IUnknown自前メソッド開始 vtbl3

メソッド 15

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

vtbl 3 HRESULT GetItemType(INT* pItemType)
pItemTypeINT*outアイテムの種別フラグを受け取るポインタ。WiaItemTypeFolder/WiaItemTypeImage等。
vtbl 4 HRESULT AnalyzeItem(INT lFlags)
lFlagsINTin解析動作を制御するフラグ。現状は0を指定する。
vtbl 5 HRESULT EnumChildItems(IEnumWiaItem** ppIEnumWiaItem)
ppIEnumWiaItemIEnumWiaItem**out子アイテムの列挙子IEnumWiaItemを受け取る出力ポインタ。
vtbl 6 HRESULT DeleteItem(INT lFlags)
lFlagsINTin削除動作を制御するフラグ。現状は0を指定する。
vtbl 7 HRESULT CreateChildItem(INT lFlags, LPWSTR bstrItemName, LPWSTR bstrFullItemName, IWiaItem** ppIWiaItem)
lFlagsINTin作成動作を制御するフラグ。
bstrItemNameLPWSTRin作成する子アイテムの名前を示すBSTR文字列。
bstrFullItemNameLPWSTRin作成する子アイテムの完全名を示すBSTR文字列。
ppIWiaItemIWiaItem**out生成された子アイテムIWiaItemを受け取る出力ポインタ。
vtbl 8 HRESULT EnumRegisterEventInfo(INT lFlags, GUID* pEventGUID, IEnumWIA_DEV_CAPS** ppIEnum)
lFlagsINTin列挙動作を制御するフラグ。現状は0を指定する。
pEventGUIDGUID*in対象イベントを識別するGUIDへのポインタ。
ppIEnumIEnumWIA_DEV_CAPS**outイベント能力の列挙子IEnumWIA_DEV_CAPSを受け取る出力ポインタ。
vtbl 9 HRESULT FindItemByName(INT lFlags, LPWSTR bstrFullItemName, IWiaItem** ppIWiaItem)
lFlagsINTin検索動作を制御するフラグ。現状は0を指定する。
bstrFullItemNameLPWSTRin検索するアイテムの完全名を示すBSTR文字列。
ppIWiaItemIWiaItem**out見つかったアイテムIWiaItemを受け取る出力ポインタ。
vtbl 10 HRESULT DeviceDlg(HWND hwndParent, INT lFlags, INT lIntent, INT* plItemCount, IWiaItem*** ppIWiaItem)
hwndParentHWNDinデバイス設定ダイアログの親ウィンドウハンドル。
lFlagsINTinダイアログ動作フラグ。WIA_DEVICE_DIALOG_*値を指定する。
lIntentINTin取得目的を示すインテントフラグ。WIA_INTENT_*値を指定する。
plItemCountINT*inout選択されたアイテム数を受け取るポインタ。
ppIWiaItemIWiaItem***inout選択アイテムの配列を受け取る出力ポインタ(配列の配列)。
vtbl 11 HRESULT DeviceCommand(INT lFlags, GUID* pCmdGUID, IWiaItem** pIWiaItem)
lFlagsINTinコマンド動作を制御するフラグ。現状は0を指定する。
pCmdGUIDGUID*in実行するデバイスコマンドを識別するGUID(WIA_CMD_*)へのポインタ。
pIWiaItemIWiaItem**inoutコマンドが返すアイテムを受け取る出力ポインタ。NULL可。
vtbl 12 HRESULT GetRootItem(IWiaItem** ppIWiaItem)
ppIWiaItemIWiaItem**outデバイスのルートアイテムIWiaItemを受け取る出力ポインタ。
vtbl 13 HRESULT EnumDeviceCapabilities(INT lFlags, IEnumWIA_DEV_CAPS** ppIEnumWIA_DEV_CAPS)
lFlagsINTin列挙対象を絞るフラグ。WIA_DEVICE_COMMANDS/WIA_DEVICE_EVENTS等。
ppIEnumWIA_DEV_CAPSIEnumWIA_DEV_CAPS**outデバイス能力の列挙子IEnumWIA_DEV_CAPSを受け取る出力ポインタ。
vtbl 14 HRESULT DumpItemData(LPWSTR* bstrData)
bstrDataLPWSTR*outアイテムデータの文字列表現を受け取るBSTRへのポインタ。デバッグ用途。
vtbl 15 HRESULT DumpDrvItemData(LPWSTR* bstrData)
bstrDataLPWSTR*outドライバアイテムデータの文字列表現を受け取るBSTRへのポインタ。デバッグ用途。
vtbl 16 HRESULT DumpTreeItemData(LPWSTR* bstrData)
bstrDataLPWSTR*outアイテムツリーの文字列表現を受け取るBSTRへのポインタ。デバッグ用途。
vtbl 17 HRESULT Diagnostic(DWORD ulSize, BYTE* pBuffer)
ulSizeDWORDinpBufferが指すバッファのバイトサイズ。
pBufferBYTE*in診断用に送受信するデータバッファへのポインタ。

HSP用 COM定義

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

出力引数: 
#define global IID_IWiaItem "{4DB1AD10-3391-11D2-9A33-00C04FA36145}"
#usecom global IWiaItem IID_IWiaItem "{}"
#comfunc global IWiaItem_GetItemType             3 var
#comfunc global IWiaItem_AnalyzeItem             4 int
#comfunc global IWiaItem_EnumChildItems          5 sptr
#comfunc global IWiaItem_DeleteItem              6 int
#comfunc global IWiaItem_CreateChildItem         7 int,wstr,wstr,sptr
#comfunc global IWiaItem_EnumRegisterEventInfo   8 int,var,sptr
#comfunc global IWiaItem_FindItemByName          9 int,wstr,sptr
#comfunc global IWiaItem_DeviceDlg               10 sptr,int,int,var,sptr
#comfunc global IWiaItem_DeviceCommand           11 int,var,sptr
#comfunc global IWiaItem_GetRootItem             12 sptr
#comfunc global IWiaItem_EnumDeviceCapabilities  13 int,sptr
#comfunc global IWiaItem_DumpItemData            14 var
#comfunc global IWiaItem_DumpDrvItemData         15 var
#comfunc global IWiaItem_DumpTreeItemData        16 var
#comfunc global IWiaItem_Diagnostic              17 int,var
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。
; ※ハンドル/void*等の不透明ポインタは IronHSP では intptr 指定が可能。