структура WIA_DEV_CAP_DRV (wiamindr_lh.h)

Статья
02/07/2025

Структура WIA_DEV_CAP_DRV используется для перечисления возможностей устройства. Возможность устройства определяется событием или командой, которую поддерживает устройство.

Синтаксис

typedef struct _WIA_DEV_CAP_DRV {
  GUID     *guid;
  ULONG    ulFlags;
  LPOLESTR wszName;
  LPOLESTR wszDescription;
  LPOLESTR wszIcon;
} WIA_DEV_CAP_DRV, *PWIA_DEV_CAP_DRV;

Члены

guid

Указывает на GUID, определяющий возможности устройства. Этот элемент можно задать для любого из значений, указанных для команд устройства WIA (WIA_CMD_команд XXX) или идентификаторов событий WIA (WIA_EVENT_XXX идентификаторов событий). Дополнительные сведения см. в командах устройств WIA.

Драйвер может определить собственный GUID возможностей, который он может отправить на устройство. Приложение должно иметь конкретные знания об этой возможности, чтобы она могла реагировать на новую возможность, однако. Приложение обычно распознает только стандартные идентификаторы GUID И СОБЫТИЙ WIA (WIA_CMD_XXX и WIA_EVENT_XXX).

ulFlags

Указывает тип события. Этот элемент можно задать для одного или обоих из следующих элементов:

Флаг	Значение
WIA_ACTION_EVENT	Приложение может зарегистрировать действие для данного события с помощью методов IWiaDevMgr::RegisterEventCallbackProgram и методов IwiaDevMgr::RegisterEventCallbackCLSID. Событие действия запускает приложение, зарегистрированное для обработки такого события.
WIA_NOTIFICATION_EVENT	Приложение может зарегистрировать уведомление для данного события с помощью метода IwiaDevMgr::RegisterEventCallbackInterface. Событие уведомления отправляется только приложениям, которые уже запущены.

Флаг

Значение

WIA_ACTION_EVENT

Приложение может зарегистрировать действие для данного события с помощью методов IWiaDevMgr::RegisterEventCallbackProgram и методов IwiaDevMgr::RegisterEventCallbackCLSID. Событие действия запускает приложение, зарегистрированное для обработки такого события.

WIA_NOTIFICATION_EVENT

Приложение может зарегистрировать уведомление для данного события с помощью метода IwiaDevMgr::RegisterEventCallbackInterface. Событие уведомления отправляется только приложениям, которые уже запущены.

wszName

Указывает строку, содержащую короткую версию имени возможности.

wszDescription

Указывает строку, содержащую версию имени возможности, которую можно отобразить пользователю.

wszIcon

Указывает строку, содержащую имя значка для этой возможности. Значок можно отобразить пользователю.

Замечания

Служба WIA вызывает функцию мини-driver IWiaMiniDrv::d rvGetCapabilities, чтобы заполнить элементы структуры WIA_DEV_CAP_DRV.

Когда драйвер перечисляет обработчики событий, единственным допустимым значением является WIA_IS_DEFAULT_HANDLER; значение, указывающее, что зарегистрированный обработчик должен использоваться.

Требования

Требование	Ценность
заголовка	wiamindr_lh.h (включить Wiamindr.h)

См. также

возможности драйвера

IWiaMiniDrv::d rvGetCapabilities

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