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

IWiaItem2

COM
📘 Microsoft Learn (日本語) · English
IID6cba0075-1287-407d-9b77-cf0e030435cc継承元IUnknown自前メソッド開始 vtbl3

メソッド 16

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

vtbl 3 HRESULT CreateChildItem(INT lItemFlags, INT lCreationFlags, LPWSTR bstrItemName, IWiaItem2** ppIWiaItem2)
lItemFlagsINTin作成する子アイテムの種別フラグ。WiaItemTypeFolder等を指定する。
lCreationFlagsINTin作成時の動作を制御するフラグ。
bstrItemNameLPWSTRin作成する子アイテムの名前を示すBSTR文字列。
ppIWiaItem2IWiaItem2**out生成された子アイテムIWiaItem2を受け取る出力ポインタ。
vtbl 4 HRESULT DeleteItem(INT lFlags)
lFlagsINTin削除動作を制御するフラグ。現状は0を指定する。
vtbl 5 HRESULT EnumChildItems(GUID* pCategoryGUID, IEnumWiaItem2** ppIEnumWiaItem2)
pCategoryGUIDGUID*inoptional列挙を絞るアイテムカテゴリのGUIDへのポインタ。NULLで全件。
ppIEnumWiaItem2IEnumWiaItem2**out子アイテムの列挙子IEnumWiaItem2を受け取る出力ポインタ。
vtbl 6 HRESULT FindItemByName(INT lFlags, LPWSTR bstrFullItemName, IWiaItem2** ppIWiaItem2)
lFlagsINTin検索動作を制御するフラグ。現状は0を指定する。
bstrFullItemNameLPWSTRin検索するアイテムの完全名を示すBSTR文字列。
ppIWiaItem2IWiaItem2**out見つかったアイテムIWiaItem2を受け取る出力ポインタ。
vtbl 7 HRESULT GetItemCategory(GUID* pItemCategoryGUID)
pItemCategoryGUIDGUID*outアイテムのカテゴリを示すGUIDを受け取るポインタ。WIA_CATEGORY_*。
vtbl 8 HRESULT GetItemType(INT* pItemType)
pItemTypeINT*outアイテムの種別フラグを受け取るポインタ。WiaItemTypeImage等。
vtbl 9 HRESULT DeviceDlg(INT lFlags, HWND hwndParent, LPWSTR bstrFolderName, LPWSTR bstrFilename, INT* plNumFiles, LPWSTR** ppbstrFilePaths, IWiaItem2** ppItem)
lFlagsINTinダイアログ動作フラグ。WIA_DEVICE_DIALOG_*値を指定する。
hwndParentHWNDin設定ダイアログの親ウィンドウハンドル。
bstrFolderNameLPWSTRin取得画像の保存先フォルダを示すBSTR文字列。
bstrFilenameLPWSTRin保存ファイル名のテンプレートを示すBSTR文字列。
plNumFilesINT*out保存されたファイル数を受け取るポインタ。
ppbstrFilePathsLPWSTR**out保存された各ファイルパスの配列を受け取る出力ポインタ。
ppItemIWiaItem2**outoptional選択されたアイテムIWiaItem2を受け取る出力ポインタ。
vtbl 10 HRESULT DeviceCommand(INT lFlags, GUID* pCmdGUID, IWiaItem2** ppIWiaItem2)
lFlagsINTinコマンド動作を制御するフラグ。現状は0を指定する。
pCmdGUIDGUID*in実行するデバイスコマンドを識別するGUID(WIA_CMD_*)へのポインタ。
ppIWiaItem2IWiaItem2**inoutコマンドが返すアイテムIWiaItem2を受け取る出力ポインタ。NULL可。
vtbl 11 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 12 HRESULT CheckExtension(INT lFlags, LPWSTR bstrName, GUID* riidExtensionInterface, BOOL* pbExtensionExists)
lFlagsINTin動作を制御するフラグ。現状は0を指定する。
bstrNameLPWSTRin拡張カテゴリの名前を示すBSTR文字列。
riidExtensionInterfaceGUID*in確認する拡張インターフェイスのIIDへのポインタ。
pbExtensionExistsBOOL*inout拡張が存在するか否かを受け取るBOOLへのポインタ。
vtbl 13 HRESULT GetExtension(INT lFlags, LPWSTR bstrName, GUID* riidExtensionInterface, void** ppOut)
lFlagsINTin動作を制御するフラグ。現状は0を指定する。
bstrNameLPWSTRin取得する拡張カテゴリの名前を示すBSTR文字列。
riidExtensionInterfaceGUID*in要求する拡張インターフェイスのIIDへのポインタ。
ppOutvoid**inout取得した拡張インターフェイスを受け取る汎用出力ポインタ。
vtbl 14 HRESULT GetParentItem(IWiaItem2** ppIWiaItem2)
ppIWiaItem2IWiaItem2**out親アイテムIWiaItem2を受け取る出力ポインタ。
vtbl 15 HRESULT GetRootItem(IWiaItem2** ppIWiaItem2)
ppIWiaItem2IWiaItem2**outデバイスのルートアイテムIWiaItem2を受け取る出力ポインタ。
vtbl 16 HRESULT GetPreviewComponent(INT lFlags, IWiaPreview** ppWiaPreview)
lFlagsINTin動作を制御するフラグ。現状は0を指定する。
ppWiaPreviewIWiaPreview**out取得したプレビューコンポーネントIWiaPreviewを受け取る出力ポインタ。
vtbl 17 HRESULT EnumRegisterEventInfo(INT lFlags, GUID* pEventGUID, IEnumWIA_DEV_CAPS** ppIEnum)
lFlagsINTin列挙動作を制御するフラグ。現状は0を指定する。
pEventGUIDGUID*in対象イベントを識別するGUIDへのポインタ。
ppIEnumIEnumWIA_DEV_CAPS**outイベント能力の列挙子IEnumWIA_DEV_CAPSを受け取る出力ポインタ。
vtbl 18 HRESULT Diagnostic(DWORD ulSize, BYTE* pBuffer)
ulSizeDWORDinpBufferが指すバッファのバイトサイズ。
pBufferBYTE*in診断用に送受信するデータバッファへのポインタ。

HSP用 COM定義

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

出力引数: 
#define global IID_IWiaItem2 "{6CBA0075-1287-407D-9B77-CF0E030435CC}"
#usecom global IWiaItem2 IID_IWiaItem2 "{}"
#comfunc global IWiaItem2_CreateChildItem         3 int,int,wstr,sptr
#comfunc global IWiaItem2_DeleteItem              4 int
#comfunc global IWiaItem2_EnumChildItems          5 var,sptr
#comfunc global IWiaItem2_FindItemByName          6 int,wstr,sptr
#comfunc global IWiaItem2_GetItemCategory         7 var
#comfunc global IWiaItem2_GetItemType             8 var
#comfunc global IWiaItem2_DeviceDlg               9 int,sptr,wstr,wstr,var,var,sptr
#comfunc global IWiaItem2_DeviceCommand           10 int,var,sptr
#comfunc global IWiaItem2_EnumDeviceCapabilities  11 int,sptr
#comfunc global IWiaItem2_CheckExtension          12 int,wstr,var,var
#comfunc global IWiaItem2_GetExtension            13 int,wstr,var,sptr
#comfunc global IWiaItem2_GetParentItem           14 sptr
#comfunc global IWiaItem2_GetRootItem             15 sptr
#comfunc global IWiaItem2_GetPreviewComponent     16 int,sptr
#comfunc global IWiaItem2_EnumRegisterEventInfo   17 int,var,sptr
#comfunc global IWiaItem2_Diagnostic              18 int,var
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。
; ※ハンドル/void*等の不透明ポインタは IronHSP では intptr 指定が可能。