IWiaItem2：:D eviceDlg 方法

向用户显示一个对话框，以准备获取图像。

语法

HRESULT DeviceDlg(
  [in]      LONG      lFlags,
  [in]      HWND      hwndParent,
  [in]      BSTR      bstrFolderName,
  [in]      BSTR      bstrFilename,
  [in]      LONG      *plNumFiles,
  [in, out] BSTR      **ppbstrFilePaths,
  [in, out] IWiaItem2 **ppIWiaItem2
);

参数

lFlags [in]

类型： LONG

指定一组控制对话框操作的标志。 该值可以是 0 来表示默认行为，也可以是 WiaFlag 中所述的任何WIA_DEVICE_DIALOG标志。

hwndParent [in]

类型：HWND

父窗口的句柄。

bstrFolderName [in]

类型： BSTR

指定要在其中传输文件的文件夹名称。

bstrFilename [in]

类型： BSTR

指定模板文件名。

plNumFiles [in]

类型： LONG*

指向 ppbstrFilePaths 数组中的项数的指针。

ppbstrFilePaths [in， out]

类型： BSTR**

指向扫描文件的路径数组的指针的地址。 在调用 IWiaItem2：:D eviceDlg 之前，初始化指针以指向大小为) 0 (0 的数组。

ppIWiaItem2 [in， out]

类型： IWiaItem2**

指向 IWiaItem2 接口的指针数组的地址。

返回值

类型： HRESULT

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

备注

此方法向用户显示一个对话框，应用程序使用该对话框收集图像获取所需的所有信息。 它还用于指定图像扫描属性，例如亮度和对比度。

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

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

要求

要求	值
最低受支持的客户端	Windows Vista [仅限桌面应用]
最低受支持的服务器	Windows Server 2008 [仅限桌面应用]
标头	Wia.h
IDL	Wia.idl