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

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

  • Статья

Структура 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 commands) или идентификаторов событий WIA (WIA_EVENT_XXXX ). Дополнительные сведения см. в разделе Команды устройства WIA.

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

ulFlags

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

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

wszName

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

wszDescription

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

wszIcon

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

Комментарии

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

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

Требования

Требование Значение
Заголовок wiamindr_lh.h (включая Wiamindr.h)

См. также раздел

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

IWiaMiniDrv::d rvGetCapabilities