IWiaItem：:D eviceDlg 方法 (wia_xp.h)

应用程序使用 IWiaItem：:D eviceDlg 方法向用户显示一个对话框，以准备获取图像。

语法

HRESULT DeviceDlg(
  [in]  HWND     hwndParent,
  [in]  LONG     lFlags,
  [in]  LONG     lIntent,
  [out] LONG     *plItemCount,
  [out] IWiaItem ***ppIWiaItem
);

参数

[in] hwndParent

类型：HWND

对话框的父窗口的句柄。

[in] lFlags

类型： LONG

指定一组控制对话框操作的标志。 可以设置为以下任何值：

标志	含义
0	默认行为。
WIA_DEVICE_DIALOG_SINGLE_IMAGE	在“设备图像获取”对话框中，将图像选择限制为单个图像。
WIA_DEVICE_DIALOG_USE_COMMON_UI	使用系统 UI（如果可用），而不是供应商提供的 UI。 如果系统 UI 不可用，则使用供应商 UI。 如果两个 UI 都不可用，该函数将返回E_NOTIMPL。

[in] lIntent

类型： LONG

指定图像要表示的数据类型。 有关图像意向值的列表，请参阅 图像意向常量。

注意 此方法忽略所有 WIA_INTENT_IMAGE_* 图像意向。

 

[out] plItemCount

类型： LONG*

接收 由 ppIWiaItem 参数指示的数组中的项数。

[out] ppIWiaItem

类型： IWiaItem***

接收指向 IWiaItem 接口的指针数组的地址。

返回值

类型： HRESULT

如果该方法成功，则返回 S_OK。 否则，将返回 HRESULT 错误代码。

注解

此方法向用户显示一个对话框，应用程序使用该对话框收集图像获取所需的所有信息。 例如，此对话框使用户能够选择要从相机下载的图像。 使用扫描仪时，它还用于指定图像扫描属性，例如亮度和对比度。

此方法返回后，应用程序可以使用 IWiaDataTransfer 接口获取映像。

应用程序必须为其通过 ppIWiaItem 参数接收的接口指针数组中的每个元素调用 IUnknown：：Release 方法。 应用程序还必须使用 CoTaskMemFree 释放数组。

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

要求

要求	值
最低受支持的客户端	Windows 2000 专业版、Windows XP [仅限桌面应用]
最低受支持的服务器	Windows Server 2003 [仅限桌面应用]
目标平台	Windows
标头	wia_xp.h (包括 Wia.h)
Library	Wiaguid.lib
DLL	Wiaservc.dll