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

此方法可以返回其中一个值。

返回代码 说明
S_OK
已成功选择设备。
S_FALSE
用户取消了对话框。
WIA_S_NO_DEVICE_AVAILABLE
没有 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 [仅限桌面应用]
标头
Wia.h
IDL
Wia.idl