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

Статья
08/08/2023

Метод IWiaMiniDrv::d rvDeviceCommand выдает команду устройству WIA.

Синтаксис

HRESULT drvDeviceCommand(
  BYTE        *__MIDL__IWiaMiniDrv0043,
  LONG        __MIDL__IWiaMiniDrv0044,
  const GUID  *__MIDL__IWiaMiniDrv0045,
  IWiaDrvItem **__MIDL__IWiaMiniDrv0046,
  LONG        *__MIDL__IWiaMiniDrv0047
);

Параметры

__MIDL__IWiaMiniDrv0043

lFlags [in]

Зарезервировано.

__MIDL__IWiaMiniDrv0044

pWiasContext [in]

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

__MIDL__IWiaMiniDrv0045

plCommand [in]

Указывает на GUID команды WIA.

__MIDL__IWiaMiniDrv0046

plDevErrVal [out]

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

__MIDL__IWiaMiniDrv0047

ppWiaDrvItem [out, optional]

Указывает на расположение памяти, которое может получить указатель на интерфейс IWiaDrvItem. См. примечания ниже.

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

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

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

Метод IWiaMiniDrv::d rvDeviceCommand вызывается службой WIA для выдачи на устройство команды, созданной службой WIA или приложением. Служба WIA вызывает только метод IWiaMiniDrv::d rvDeviceCommand для команды, которую устройство может поддерживать в методе IWiaMiniDrv::d rvGetCapabilities.

Параметр ppWiaDrvItem следует считать необязательным, так как мини-диск обычно не задает расположение памяти, на который он указывает. Однако для некоторых команд мини-диск помещает адрес только что созданного элемента в расположение, на которое указывает этот параметр. Например, если выполняется команда для создания снимка (для параметра plCommand задано значение WIA_CMD_TAKE_PICTURE), устройство создает новое изображение, в результате чего мини-диск создает новый элемент в дереве элементов драйвера и задает для *ppWiaDrvItem адрес нового элемента. Это сообщает службе WIA о том, что был создан новый элемент.

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

Служба WIA не записывает свойства перед вызовом этого метода. Если команда использует параметры свойств, перед выполнением команды мини-driver должен вызвать IWiaMiniDrv::d rvWriteItemProperties . Например, команда для создания снимка, WIA_CMD_TAKE_PICTURE, может полагаться на скорость затвора и параметры диафрагмы, которые необходимо записать на устройство перед выполнением команды.

Требования

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

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

IWiaMiniDrv

IWiaMiniDrv::d rvGetCapabilities

IWiaMiniDrv::d rvWriteItemProperties

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