Поделиться через

Метод 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 [только классические приложения]
Заголовок
Wia.h
IDL
Wia.idl