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 [仅限桌面应用] |
| 标头 |
|
| IDL |
|