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

IWiaDevMgr

COM
📘 Microsoft Learn (日本語) · English
IID5eb2502a-8cf1-11d1-bf92-0060081ed811継承元IUnknown自前メソッド開始 vtbl3

メソッド 9

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

vtbl 3 HRESULT EnumDeviceInfo(INT lFlag, IEnumWIA_DEV_INFO** ppIEnum)
lFlagINTin列挙する情報量を示すフラグ。WIA_DEVINFO_ENUM_LOCAL等を指定する。
ppIEnumIEnumWIA_DEV_INFO**outデバイス情報列挙子IEnumWIA_DEV_INFOを受け取る出力ポインタ。
vtbl 4 HRESULT CreateDevice(LPWSTR bstrDeviceID, IWiaItem** ppWiaItemRoot)
bstrDeviceIDLPWSTRin接続対象デバイスのIDを示すBSTR文字列。
ppWiaItemRootIWiaItem**out生成されたデバイスのルートアイテムIWiaItemを受け取る出力ポインタ。
vtbl 5 HRESULT SelectDeviceDlg(HWND hwndParent, INT lDeviceType, INT lFlags, LPWSTR* pbstrDeviceID, IWiaItem** ppItemRoot)
hwndParentHWNDinデバイス選択ダイアログの親ウィンドウハンドル。
lDeviceTypeINTin選択対象のデバイス種別。StiDeviceTypeScanner等を指定する。
lFlagsINTinダイアログ動作フラグ。WIA_DEVICE_DIALOG_*値を指定する。
pbstrDeviceIDLPWSTR*inout選択されたデバイスIDを受け取るBSTRへのポインタ。
ppItemRootIWiaItem**out選択デバイスのルートアイテムIWiaItemを受け取る出力ポインタ。
vtbl 6 HRESULT SelectDeviceDlgID(HWND hwndParent, INT lDeviceType, INT lFlags, LPWSTR* pbstrDeviceID)
hwndParentHWNDinデバイス選択ダイアログの親ウィンドウハンドル。
lDeviceTypeINTin選択対象のデバイス種別。StiDeviceTypeScanner等を指定する。
lFlagsINTinダイアログ動作フラグ。WIA_DEVICE_DIALOG_*値を指定する。
pbstrDeviceIDLPWSTR*inout選択されたデバイスIDのみを受け取るBSTRへのポインタ。
vtbl 7 HRESULT GetImageDlg(HWND hwndParent, INT lDeviceType, INT lFlags, INT lIntent, IWiaItem* pItemRoot, LPWSTR bstrFilename, GUID* pguidFormat)
hwndParentHWNDin画像取得ダイアログの親ウィンドウハンドル。
lDeviceTypeINTin対象デバイス種別。StiDeviceTypeScanner等を指定する。
lFlagsINTinダイアログ動作フラグ。WIA_DEVICE_DIALOG_*値を指定する。
lIntentINTin取得目的を示すインテントフラグ。WIA_INTENT_IMAGE_TYPE_COLOR等。
pItemRootIWiaItem*in取得元デバイスのルートアイテムIWiaItem。NULL可。
bstrFilenameLPWSTRin保存先ファイルパスを示すBSTR文字列。
pguidFormatGUID*inout入出力。希望/実際の画像形式GUIDを受け渡すポインタ。
vtbl 8 HRESULT RegisterEventCallbackProgram(INT lFlags, LPWSTR bstrDeviceID, GUID* pEventGUID, LPWSTR bstrCommandline, LPWSTR bstrName, LPWSTR bstrDescription, LPWSTR bstrIcon)
lFlagsINTin登録/解除を示すフラグ。WIA_REGISTER_EVENT_CALLBACK/WIA_UNREGISTER_EVENT_CALLBACK。
bstrDeviceIDLPWSTRin対象デバイスのIDを示すBSTR文字列。
pEventGUIDGUID*in登録対象イベントを識別するGUIDへのポインタ。
bstrCommandlineLPWSTRinイベント発生時に起動するコマンドラインを示すBSTR文字列。
bstrNameLPWSTRin登録するハンドラの表示名を示すBSTR文字列。
bstrDescriptionLPWSTRin登録するハンドラの説明を示すBSTR文字列。
bstrIconLPWSTRinハンドラのアイコン位置を示すBSTR文字列。
vtbl 9 HRESULT RegisterEventCallbackInterface(INT lFlags, LPWSTR bstrDeviceID, GUID* pEventGUID, IWiaEventCallback* pIWiaEventCallback, IUnknown** pEventObject)
lFlagsINTin登録/解除を示すフラグ。WIA_REGISTER_EVENT_CALLBACK等を指定する。
bstrDeviceIDLPWSTRin対象デバイスのIDを示すBSTR文字列。
pEventGUIDGUID*in登録対象イベントを識別するGUIDへのポインタ。
pIWiaEventCallbackIWiaEventCallback*inイベント受信を行うIWiaEventCallback実装へのポインタ。
pEventObjectIUnknown**out登録解除に使う接続オブジェクトを受け取る出力ポインタ。
vtbl 10 HRESULT RegisterEventCallbackCLSID(INT lFlags, LPWSTR bstrDeviceID, GUID* pEventGUID, GUID* pClsID, LPWSTR bstrName, LPWSTR bstrDescription, LPWSTR bstrIcon)
lFlagsINTin登録/解除を示すフラグ。WIA_REGISTER_EVENT_CALLBACK等を指定する。
bstrDeviceIDLPWSTRin対象デバイスのIDを示すBSTR文字列。
pEventGUIDGUID*in登録対象イベントを識別するGUIDへのポインタ。
pClsIDGUID*in起動するCOMサーバーのCLSIDへのポインタ。
bstrNameLPWSTRin登録するハンドラの表示名を示すBSTR文字列。
bstrDescriptionLPWSTRin登録するハンドラの説明を示すBSTR文字列。
bstrIconLPWSTRinハンドラのアイコン位置を示すBSTR文字列。
vtbl 11 HRESULT AddDeviceDlg(HWND hwndParent, INT lFlags)
hwndParentHWNDinデバイス追加ダイアログの親ウィンドウハンドル。
lFlagsINTin予約フラグ。現状は0を指定する。

HSP用 COM定義

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

出力引数: 
#define global IID_IWiaDevMgr "{5EB2502A-8CF1-11D1-BF92-0060081ED811}"
#usecom global IWiaDevMgr IID_IWiaDevMgr "{A1F4E726-8CF1-11D1-BF92-0060081ED811}"
#comfunc global IWiaDevMgr_EnumDeviceInfo                  3 int,sptr
#comfunc global IWiaDevMgr_CreateDevice                    4 wstr,sptr
#comfunc global IWiaDevMgr_SelectDeviceDlg                 5 sptr,int,int,var,sptr
#comfunc global IWiaDevMgr_SelectDeviceDlgID               6 sptr,int,int,var
#comfunc global IWiaDevMgr_GetImageDlg                     7 sptr,int,int,int,sptr,wstr,var
#comfunc global IWiaDevMgr_RegisterEventCallbackProgram    8 int,wstr,var,wstr,wstr,wstr,wstr
#comfunc global IWiaDevMgr_RegisterEventCallbackInterface  9 int,wstr,var,sptr,sptr
#comfunc global IWiaDevMgr_RegisterEventCallbackCLSID      10 int,wstr,var,var,wstr,wstr,wstr
#comfunc global IWiaDevMgr_AddDeviceDlg                    11 sptr,int
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※#usecom 末尾は CoCreateInstance 用のクラスID(コクラスCLSID, SDKから自動取得)。
; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。
; ※ハンドル/void*等の不透明ポインタは IronHSP では intptr 指定が可能。