Метод IWiaItem::D eviceDlg (wia_xp.h)

Метод IWiaItem::D eviceDlg используется приложениями для отображения диалогового окна для подготовки к извлечению изображения.

Синтаксис

HRESULT DeviceDlg(
  [in]  HWND     hwndParent,
  [in]  LONG     lFlags,
  [in]  LONG     lIntent,
  [out] LONG     *plItemCount,
  [out] IWiaItem ***ppIWiaItem
);

Параметры

[in] hwndParent

Тип: HWND

Дескриптор родительского окна диалогового окна.

[in] lFlags

Тип: LONG

Задает набор флагов, управляющих операцией диалогового окна. Можно задать любое из следующих значений:

Flag	Значение
0	Поведение по умолчанию.
WIA_DEVICE_DIALOG_SINGLE_IMAGE	Ограничьте выбор изображения одним изображением в диалоговом окне получения образа устройства.
WIA_DEVICE_DIALOG_USE_COMMON_UI	Используйте системный пользовательский интерфейс , если он доступен, а не предоставленный поставщиком пользовательский интерфейс. Если пользовательский интерфейс системы недоступен, используется пользовательский интерфейс поставщика. Если пользовательский интерфейс недоступен, функция возвращает E_NOTIMPL.

[in] lIntent

Тип: LONG

Указывает тип данных, которые должно представлять изображение. Список значений намерений изображений см. в разделе Константы намерения изображений.

Примечание Этот метод игнорирует все намерения изображений WIA_INTENT_IMAGE_*.

 

[out] plItemCount

Тип: LONG*

Получает количество элементов в массиве, указанное параметром ppIWiaItem .

[out] ppIWiaItem

Тип: IWiaItem***

Получает адрес массива указателей на интерфейсы IWiaItem .

Возвращаемое значение

Тип: HRESULT

Если этот метод завершается успешно, он возвращает S_OK. В противном случае возвращается код ошибки HRESULT .

Комментарии

Этот метод отображает диалоговое окно для пользователя, которое приложение использует для сбора всех сведений, необходимых для получения изображения. Например, это диалоговое окно позволяет пользователю выбирать изображения для скачивания с камеры. При использовании сканера он также используется для указания свойств сканирования изображения, таких как яркость и контрастность.

После возврата этого метода приложение может использовать интерфейс IWiaDataTransfer для получения изображения.

Приложения должны вызывать метод IUnknown::Release для каждого элемента в массиве указателей интерфейса, которые они получают с помощью параметра ppIWiaItem . Приложения также должны освободить массив с помощью CoTaskMemFree.

Приложениям рекомендуется сделать выбор устройств и изображений доступными с помощью пункта меню с именем "Из сканера" или "Камера " в меню Файл .

Требования

Требование	Значение
Минимальная версия клиента	Windows 2000 Professional, Windows XP [только классические приложения]
Минимальная версия сервера	Windows Server 2003 [только классические приложения]
Целевая платформа	Windows
Header	wia_xp.h (включая Wia.h)
Библиотека	Wiaguid.lib
DLL	Wiaservc.dll