IWiaDevMgr2：：SelectDeviceDlg 方法
显示一个对话框，使用户能够选择硬件设备进行图像获取。
语法
HRESULT SelectDeviceDlg(
[in] HWND hwndParent,
[in] LONG lDeviceType,
[in] LONG lFlags,
[in, out] BSTR *pbstrDeviceID,
[out, retval] IWiaItem2 **ppItemRoot
);
参数
-
hwndParent [in]
-
类型：HWND
指定“ 选择设备 ”对话框的父窗口。
-
lDeviceType [in]
-
类型： LONG
指定使用哪种类型的 WIA 2.0 设备。 有关可能值的列表，请参阅 WIA 设备类型说明符 。
-
lFlags [in]
-
类型： LONG
指定对话框的行为。 该值可以是下列值之一。
-
0
-
使用默认行为。
-
WIA_SELECT_DEVICE_NODEFAULT
-
显示对话框，即使只有一个匹配的设备。
pbstrDeviceID [in， out]
类型： BSTR*
在输出时，接收一个字符串，其中包含设备的标识符字符串。 输入时，如果需要此信息，则传递指针的地址;如果不需要，则传递 NULL 。
ppItemRoot [out， retval]
类型： IWiaItem2**
接收指向表示所选 WIA 2.0 设备的分层树的根项 的 IWiaItem2 接口的指针的地址。 如果未找到任何设备，则会收到 NULL。
返回值
类型： HRESULT
此方法可以返回其中一个值。
| 返回代码 | 说明 |
|---|---|
|
已成功选择设备。 |
|
用户已取消对话框。 |
|
没有 WIA 2.0 硬件设备与 lDeviceType 参数中给出的规范相匹配。 |
备注
此方法创建并显示 “选择设备 ”对话框，以便用户可以选择 WIA 2.0 设备进行图像获取。 如果成功选择设备， IWiaDevMgr2：：SelectDeviceDlg 方法会为设备创建 IWiaItem2 对象的分层树。 它将指向根项的 IWiaItem2 接口的指针存储在参数 ppItemRoot 中。
应用程序可以通过 lDeviceType 参数指定设备类型，将向用户显示的设备限制为特定类型。 如果只有一台设备符合规范， 则 IWiaDevMgr2：：SelectDeviceDlg 不显示 “选择设备 ”对话框。 而是为设备创建 IWiaItem2 树，并将指向根项 的 IWiaItem2 接口的指针存储在参数 ppItemRoot 中。 可以通过将 WIA_SELECT_DEVICE_NODEFAULT 指定为 lFlags 参数的值来替代此行为并强制 IWiaDevMgr2：：SelectDeviceDlg 显示对话框。 如果多个 WIA 2.0 设备与规范匹配，则所有匹配的设备将显示在 “选择设备 ”对话框中，以便用户可以选择一个设备。
应用程序必须对通过 ppItemRoot 参数接收的接口指针调用 IUnknown：：Release 方法。
注意
建议应用程序通过“文件”菜单上名为“从扫描程序”的菜单项提供设备和图像选择。
要求
| 要求 | 值 |
|---|---|
| 最低受支持的客户端 |
Windows Vista [仅限桌面应用] |
| 最低受支持的服务器 |
Windows Server 2008 [仅限桌面应用] |
| 标头 |
|
| IDL |
|