Метод IWiaMiniDrv::d rvGetCapabilities (wiamindr_lh.h)

Статья
02/27/2024

Метод IWiaMiniDrv::d rvGetCapabilities возвращает массив событий и команд, поддерживаемых устройством.

Синтаксис

HRESULT drvGetCapabilities(
  BYTE            *__MIDL__IWiaMiniDrv0048,
  LONG            __MIDL__IWiaMiniDrv0049,
  LONG            *__MIDL__IWiaMiniDrv0050,
  WIA_DEV_CAP_DRV **__MIDL__IWiaMiniDrv0051,
  LONG            *__MIDL__IWiaMiniDrv0052
);

Параметры

__MIDL__IWiaMiniDrv0048

lFlags [in]

Указывает, состоит ли массив, на который указывает ppCapabilites , из команд, событий или и того, и другого. Этот параметр может иметь один из следующих флагов или оба флага, объединенные оператором OR.

Flag	Описание
WIA_DEVICE_COMMANDS	Массив состоит из команд устройства.
WIA_DEVICE_EVENTS	Массив состоит из событий устройства.

__MIDL__IWiaMiniDrv0049

pWiasContext [in]

Указатель на контекст элемента WIA.

__MIDL__IWiaMiniDrv0050

pcelt [out]

Указывает на расположение памяти, которое получит количество элементов в массиве, на который указывает параметр ppCapabilities .

__MIDL__IWiaMiniDrv0051

plDevErrVal [out]

Указывает на расположение памяти, которое получит код состояния для этого метода. Если этот метод возвращает S_OK, сохраненное значение будет равно нулю. В противном случае код ошибки, относящейся к мини-накопителю, будет храниться в расположении, на которое указывает этот параметр.

__MIDL__IWiaMiniDrv0052

ppCapabilities [out, optional]

Указывает на расположение памяти, которое получит адрес первого элемента массива WIA_DEV_CAP_DRV структур, содержащих идентификаторы GUID событий и команд, поддерживаемых устройством.

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

При успешном выполнении метод должен вернуть S_OK и очистить значение ошибки устройства, на которое указывает plDevErrVal. Если метод завершается сбоем, он должен вернуть стандартный код ошибки COM и поместить значение кода ошибки для мини-драйвера в память, на которую указывает plDevErrVal.

Значение, на которое указывает plDevErrVal , можно преобразовать в строку, вызвав IWiaMiniDrv::d rvGetDeviceErrorStr.

Служба WIA вызывает метод minidriver IWiaMiniDrv::d rvGetCapabilities , чтобы получить список возможностей команд оборудования и (или) событий устройства. В ответ на этот вызов мини-driver задает ppCapabilities с адресом массива указателей на данные GUID. Каждый GUID соответствует уведомлению о событии или команде устройства, поддерживаемой устройством создания образа. Если параметру lFlags присвоено значение WIA_DEVICE_COMMANDS, массив guid содержит команды устройства. Если для параметра lFlags задано значение WIA_DEVICE_EVENTS, массив идентификаторов GUID содержит события. Если для lFlags задано значение WIA_DEVICE_COMMANDS | WIA_DEVICE_EVENTS массив идентификаторов GUID содержит как события, так и команды, перечисленные в этом порядке.

Заголовок Wiadef.h содержит несколько предопределенных команд и событий.

Требования

Требование	Значение
Целевая платформа	Персональный компьютер
Верхняя часть	wiamindr_lh.h (включая Wiamindr.h)

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

IWiaMiniDrv

IWiaMiniDrv::d rvGetDeviceErrorStr

WIA_DEV_CAP_DRV

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