IWiaDevMgr：：SelectDeviceDlg 方法 (wia_xp.h)

IWiaDevMgr：：SelectDeviceDlg 显示一个对话框，使用户能够选择用于图像获取的硬件设备。

语法

HRESULT SelectDeviceDlg(
  [in]          HWND     hwndParent,
  [in]          LONG     lDeviceType,
  [in]          LONG     lFlags,
  [in, out]     BSTR     *pbstrDeviceID,
  [out, retval] IWiaItem **ppItemRoot
);

参数

[in] hwndParent

类型：HWND

拥有 “选择设备 ”对话框的窗口的句柄。

[in] lDeviceType

类型： LONG

指定要使用的 WIA 设备类型。 可以设置为 StiDeviceTypeDefault、 StiDeviceTypeScanner 或 StiDeviceTypeDigitalCamera。

[in] lFlags

类型： LONG

指定对话框行为。 可以设置为以下任何值：

[in, out] pbstrDeviceID

类型： BSTR*

在输出时，接收一个字符串，其中包含设备的标识符字符串。 输入时，如果需要此信息，则传递指针的地址;如果不需要，则传递 NULL 。

[out, retval] ppItemRoot

类型： IWiaItem**

接收指向表示所选 WIA 设备的树根项的 IWiaItem 接口的指针的地址。 如果未找到任何设备，则包含值 NULL。

返回值

类型： HRESULT

此方法返回以下值：

注解

此方法创建并显示 “选择设备 ”对话框，以便用户可以选择 WIA 设备进行图像获取。 如果成功选择设备， IWiaDevMgr：：SelectDeviceDlg 方法将创建设备的 IWiaItem 对象的分层树。 它将指向根项的 IWiaItem 接口的指针存储在参数 ppItemRoot 中。

通过 lDeviceType 参数指定设备类型，可以向用户显示特定类型的设备。 如果只有一台设备符合规范， 则 IWiaDevMgr：：SelectDeviceDlg 不显示 “选择设备 ”对话框。 而是为设备创建 IWiaItem 树，并在参数 ppItemRoot 中存储指向根项的 IWiaItem 接口的指针。 可以通过将 WIA_SELECT_DEVICE_NODEFAULT 作为 lFlags 参数的值来替代此行为并强制 IWiaDevMgr：：SelectDeviceDlg 显示“选择设备”对话框。

如果多个 WIA 设备与规范匹配，所有匹配设备将显示在 “选择设备 ”对话框中，以便用户可以选择一个设备。

应用程序必须对通过 ppItemRoot 参数接收的接口指针调用 IUnknown：：Release 方法。

建议应用程序通过“文件”菜单上名为“从扫描仪或相机”的菜单项提供设备和图像选择。

要求