IWiaDevMgr2::SelectDeviceDlgID 方法
显示一个对话框,使用户能够选择硬件设备进行图像获取。
语法
HRESULT SelectDeviceDlgID(
[in] HWND hwndParent,
[in] LONG lDeviceType,
[in] LONG lFlags,
[out, retval] BSTR *pbstrDeviceID
);
参数
-
hwndParent [in]
-
类型:HWND
指定 “选择设备 ”对话框的父窗口。
-
lDeviceType [in]
-
类型: LONG
指定要使用的 WIA 2.0 设备类型。 有关可能值的列表,请参阅 WIA 设备类型说明符 。
-
lFlags [in]
-
类型: LONG
指定对话框的行为。 该值可以是下列值之一。
-
0
-
使用默认行为。
-
WIA_SELECT_DEVICE_NODEFAULT
-
显示对话框,即使只有一个匹配的设备。
pbstrDeviceID [out, retval]
类型: BSTR*
指向接收设备标识符字符串的字符串的指针。
返回值
类型: HRESULT
此方法可以返回其中一个值。
返回代码 | 说明 |
---|---|
|
已成功选择设备。 |
|
用户取消了对话框。 |
|
没有 WIA 2.0 硬件设备与 lDeviceType 参数中指定的规范匹配。 |
注解
此方法创建并显示 “选择设备 ”对话框,以便用户可以选择 WIA 2.0 设备进行图像获取。 如果成功选择设备, 则 IWiaDevMgr2::SelectDeviceDlgID 方法通过其 pbstrDeviceID 参数将其标识符字符串传递给应用程序。
应用程序可以通过通过 lDeviceType 参数指定设备类型,将向用户显示的设备限制为特定类型。 如果只有一台设备符合规范, 则 IWiaDevMgr2::SelectDeviceDlgID 不显示 “选择设备 ”对话框。 而是将设备的标识符字符串传递给应用程序,而无需显示对话框。 可以通过将 WIA_SELECT_DEVICE_NODEFAULT 作为 lFlags 参数的值来替代此行为并强制 IWiaDevMgr2::SelectDeviceDlgID 显示对话框。 如果多个 WIA 2.0 设备与规范匹配,则会在 SelectDevice 对话框中显示所有匹配设备,以便用户可以选择一个设备。
备注
建议应用程序通过“文件”菜单上名为“从扫描程序”的菜单项来选择设备和图像。
要求
要求 | 值 |
---|---|
最低受支持的客户端 |
Windows Vista [仅限桌面应用] |
最低受支持的服务器 |
Windows Server 2008 [仅限桌面应用] |
标头 |
|
IDL |
|