Метод 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, чтобы представить поведение по умолчанию, или любой из флагов WIA_DEVICE_DIALOG, описанных в WiaFlag.
-
hwndParent [in]
-
Тип: HWND
Дескриптор родительского окна.
-
bstrFolderName [in]
-
Тип: BSTR
Указывает имя папки, в которой будут передаваться файлы.
-
bstrFilename [in]
-
Тип: BSTR
Указывает имя файла шаблона.
-
plNumFiles [in]
-
Тип: LONG*
Указатель на количество элементов в массиве ppbstrFilePaths .
-
ppbstrFilePaths [in, out]
-
Тип: BSTR**
Адрес указателя на массив путей для отсканированных файлов. Инициализируйте указатель так, чтобы он указывал на массив нулевого размера (0) перед вызовом IWiaItem2::D eviceDlg .
-
ppIWiaItem2 [in, out]
-
Тип: IWiaItem2**
Адрес массива указателей на интерфейсы IWiaItem2 .
Возвращаемое значение
Тип: HRESULT
Если этот метод завершается успешно, он возвращает S_OK. В противном случае возвращается код ошибки HRESULT .
Комментарии
Этот метод отображает диалоговое окно для пользователя, которое приложение использует для сбора всех сведений, необходимых для получения изображения. Он также используется для указания свойств сканирования изображения, таких как яркость и контрастность.
После возврата этого метода приложение может использовать интерфейс IWiaTransfer для получения изображения.
Приложения должны вызывать метод IUnknown::Release для каждого элемента в массиве указателей интерфейса, которые они получают с помощью параметра ppIWiaItem2 . Приложения также должны освободить массив с помощью CoTaskMemFree.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента |
Windows Vista [только классические приложения] |
| Минимальная версия сервера |
Windows Server 2008 [только классические приложения] |
| Заголовок |
|
| IDL |
|