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 |
|