Share via

DEVICEDIALOGDATA2 结构

  • 项目

定义调用设备对话所需的数据。

语法

typedef struct {
  DWORD     cbSize;
  IWiaItem2 *pIWiaItemRoot;
  DWORD     dwFlags;
  HWND      hwndParent;
  BSTR      bstrFolderName;
  BSTR      bstrFilename;
  LONG      lNumFiles;
  BSTR      *pbstrFilePaths;
  IWiaItem2 *ppWiaItem;
} DEVICEDIALOGDATA2;

成员

cbSize

类型：DWORD

指定此结构的大小（以字节为单位）。

pIWiaItemRoot

类型： IWiaItem2*

指向表示应用程序项树中有效根项的 IWiaItem2 接口。

dwFlags

类型：DWORD

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

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

 

hwndParent

类型：HWND

指定对话框的父窗口的句柄。

bstrFolderName

类型： BSTR

指定传输文件的文件夹名称。

bstrFilename

类型： BSTR

指定要用于从 WIA 项传输到 bstrFolderName 指定的目标文件夹的文件的文件名模板。 可以通过将其他字符追加到文件名模板来创建任意数量的唯一文件名。

lNumFiles

类型： LONG

接收写入 pbstrFilePaths 数组的字符串数。

pbstrFilePaths

类型： BSTR*

指向 BSTR 指针数组的指针。 每个数组元素都指向一个 BSTR，其中包含已成功传输到 bstrFolderName 标识的文件夹的文件的目标名称。 方法必须为此成员分配存储。

ppWiaItem

类型： IWiaItem2*

指向 WIA 项的 IWiaItem2 接口的指针，该接口将数据传输到 pbstrFilePaths 数组中命名的文件。

要求

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