Метод IWiaDevMgr::SelectDeviceDlgID (wia_xp.h)

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

Синтаксис

HRESULT SelectDeviceDlgID(
  [in]          HWND hwndParent,
  [in]          LONG lDeviceType,
  [in]          LONG lFlags,
  [out, retval] BSTR *pbstrDeviceID
);

Параметры

[in] hwndParent

Тип: HWND

Дескриптор окна, которому принадлежит диалоговое окно Выбор устройства .

[in] lDeviceType

Тип: LONG

Указывает тип устройства WIA для использования. Может иметь значение StiDeviceTypeDefault, StiDeviceTypeScanner или StiDeviceTypeDigitalCamera.

[in] lFlags

Тип: LONG

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

Константа	Значение
0	Использовать поведение по умолчанию.
WIA_SELECT_DEVICE_NODEFAULT	Отображение диалогового окна, даже если имеется только одно соответствующее устройство. Дополнительные сведения см. в разделе Примечания этой справочной страницы.

[out, retval] pbstrDeviceID

Тип: BSTR*

Указатель на строку, получающую строку идентификатора устройства.

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

Тип: HRESULT

Этот метод возвращает следующие значения:

Возвращаемое значение	Значение
S_OK	Устройство успешно выбрано.
S_FALSE	Пользователь отменил диалоговое окно.
WIA_S_NO_DEVICE_AVAILABLE	К компьютеру пользователя не подключены аппаратные устройства WIA, соответствующие спецификациям.

Комментарии

Этот метод работает аналогично IWiaDevMgr::SelectDeviceDlg. Основное отличие заключается в том, что при поиске соответствующего устройства не создается иерархическое дерево объектов IWiaItem для устройства.

Как и IWiaDevMgr::SelectDeviceDlg, метод IWiaDevMgr::SelectDeviceDlgID создает и отображает диалоговое окно Выбор устройства . Это позволяет пользователю выбрать устройство WIA для получения образа. Если устройство выбрано успешно, метод IWiaDevMgr::SelectDeviceDlgID передает строку идентификатора приложению через его параметр pbstrDeviceID .

Определенные типы устройств можно отобразить для пользователя, указав типы устройств с помощью параметра lDeviceType . Если только одно устройство соответствует спецификации, IWiaDevMgr::SelectDeviceDlgID не отображает диалоговое окно Выбор устройства . Вместо этого он передает строку идентификатора устройства приложению без отображения диалогового окна. Это поведение можно переопределить и принудительно принудить IWiaDevMgr::SelectDeviceDlgID отобразить диалоговое окно Выбор устройства , передав WIA_SELECT_DEVICE_NODEFAULT в качестве значения параметра lFlags .

Если спецификации соответствует несколько устройств WIA, все соответствующие устройства отображаются в диалоговом окне Выбор устройства , чтобы пользователь мог выбрать одно из них.

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

Требования

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