Метод IWiaMiniDrv::d rvDeviceCommand (wiamindr_lh.h)
Метод 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, сохраненное значение будет равно нулю. В противном случае код ошибки для мини-driver будет храниться в расположении, на которое указывает этот параметр.
__MIDL__IWiaMiniDrv0047
ppWiaDrvItem [out, необязательный]
Указывает на расположение памяти, которое может получить указатель на интерфейс IWiaDrvIte m. См. приведенные ниже замечания.
Возвращаемое значение
При успешном выполнении метод должен возвращать S_OK и очищать значение ошибки устройства, указываемое на plDevErrVal. Если метод завершается ошибкой, он должен вернуть стандартный код ошибки COM и поместить значение кода ошибки для мини-driver в память, на которую указывает plDevErrVal.
Значение, указываемое plDevErrVal, можно преобразовать в строку путем вызова IWiaMiniDrv::d rvGetDeviceErrorStr.
Замечания
Метод IWiaMiniDrv::d rvDeviceCommand вызывается службой WIA для выдачи службы WIA или созданной приложению команды на устройство. Служба WIA вызывает только метод IWiaMiniDrv::d rvDeviceCommand для команды, которую устройство может поддерживать в методе IWiaMiniDrv::d rvGetCapabilities.
Параметр ppWiaDrvItem следует считать необязательным, так как мини-driver обычно не задает расположение памяти, на который он указывает. Однако для некоторых команд мини-driver помещает адрес только что созданного элемента в расположении, на которое указывает этот параметр. Например, если выдается команда для создания рисунка (plCommand задано значение WIA_CMD_TAKE_PICTURE), устройство создает новое изображение, вызывая мини-driver для создания нового элемента в дереве элементов драйвера и задает *ppWiaDrvItem на адрес нового элемента. Это сообщает службе WIA, что был создан новый элемент.
Мини-driver может содержать список пользовательских команд, которые устройство может поддерживать в методе IWiaMiniDrv::d rvGetCapabilities.
Служба WIA не записывает никаких свойств перед вызовом этого метода. Если команда зависит от параметров свойств, мини-driver должен вызывать IWiaMiniDrv::d rvWriteItemProperties перед выполнением команды. Например, команда для создания изображения, WIA_CMD_TAKE_PICTURE, может полагаться на параметры скорости затвора и диафрагмы, которые необходимо записать на устройство перед выдачой команды.
Требования
| Требование | Ценность |
|---|---|
| целевая платформа | Настольный |
| заголовка | wiamindr_lh.h (включить Wiamindr.h) |