Метод IWiaDevMgr2::SelectDeviceDlg
Отображает диалоговое окно, позволяющее пользователю выбрать аппаратное устройство для получения изображения.
Синтаксис
HRESULT SelectDeviceDlg(
[in] HWND hwndParent,
[in] LONG lDeviceType,
[in] LONG lFlags,
[in, out] BSTR *pbstrDeviceID,
[out, retval] IWiaItem2 **ppItemRoot
);
Параметры
-
hwndParent [in]
-
Тип: HWND
Указывает родительское окно диалогового окна Выбор устройства .
-
lDeviceType [in]
-
Тип: LONG
Указывает тип используемого устройства WIA 2.0. Список возможных значений см. в разделе Описатели типов устройств WIA .
-
lFlags [in]
-
Тип: LONG
Указывает поведение диалогового окна. Значение может иметь одно из следующих значений.
-
0
-
Использовать поведение по умолчанию.
-
WIA_SELECT_DEVICE_NODEFAULT
-
Отображение диалогового окна, даже если имеется только одно соответствующее устройство.
pbstrDeviceID [вход, выход]
Тип: BSTR*
В выходных данных получает строку, содержащую строку идентификатора устройства. При входе передайте адрес указателя, если эти сведения необходимы, или NULL , если они не нужны.
ppItemRoot [out, retval]
Тип: IWiaItem2**
Получает адрес указателя на интерфейс IWiaItem2 корневого элемента иерархического дерева, представляющего выбранное устройство WIA 2.0. Если устройство не найдено, оно получает значение NULL.
Возвращаемое значение
Тип: HRESULT
Этот метод может возвращать одно из этих значений.
| Код возврата | Описание |
|---|---|
|
Устройство успешно выбрано. |
|
Пользователь отменил диалоговое окно. |
|
Аппаратные устройства WIA 2.0 не соответствуют спецификациям, указанным в параметре lDeviceType . |
Комментарии
Этот метод создает и отображает диалоговое окно Выбор устройства , чтобы пользователь смог выбрать устройство WIA 2.0 для получения изображения. Если устройство выбрано успешно, метод IWiaDevMgr2::SelectDeviceDlg создает иерархическое дерево объектов IWiaItem2 для устройства. Он сохраняет указатель на интерфейс IWiaItem2 корневого элемента в параметре ppItemRoot.
Приложение может ограничить отображаемые для пользователя устройства определенными типами, указав типы устройств с помощью параметра lDeviceType . Если спецификации соответствует только одно устройство, IWiaDevMgr2::SelectDeviceDlg не отображает диалоговое окно Выбор устройства . Вместо этого он создает дерево IWiaItem2 для устройства и сохраняет указатель на интерфейс IWiaItem2 корневого элемента в параметре ppItemRoot. Это поведение можно переопределить и принудительно отобразить диалоговое окно IWiaDevMgr2::SelectDeviceDlg , указав WIA_SELECT_DEVICE_NODEFAULT в качестве значения параметра lFlags . Если спецификации соответствует несколько устройств WIA 2.0, все соответствующие устройства отображаются в диалоговом окне Выбор устройства , чтобы пользователь мог выбрать одно из них.
Приложения должны вызывать метод IUnknown::Release для указателей интерфейса, которые они получают с помощью параметра ppItemRoot .
Примечание
Приложениям рекомендуется сделать выбор устройств и изображений доступными с помощью пункта меню "Из средства проверки " в меню Файл .
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента |
Windows Vista [только классические приложения] |
| Минимальная версия сервера |
Windows Server 2008 [только классические приложения] |
| Заголовок |
|
| IDL |
|