Метод IWiaMiniDrv::d rvGetWiaFormatInfo (wiamindr_lh.h)
Метод IWiaMiniDrv::d rvGetWiaFormatInfo находит форматы изображений и типы носителей, поддерживаемые аппаратным устройством WIA.
Синтаксис
HRESULT drvGetWiaFormatInfo(
BYTE *__MIDL__IWiaMiniDrv0059,
LONG __MIDL__IWiaMiniDrv0060,
LONG *__MIDL__IWiaMiniDrv0061,
WIA_FORMAT_INFO **__MIDL__IWiaMiniDrv0062,
LONG *__MIDL__IWiaMiniDrv0063
);
Параметры
__MIDL__IWiaMiniDrv0059
lFlags [in]
Скрытный.
__MIDL__IWiaMiniDrv0060
pWiasContext [in]
Указатель на контекст элемента WIA.
__MIDL__IWiaMiniDrv0061
pcelt [out]
Указывает на расположение памяти, которое будет получать количество элементов в массиве, на которое указывает ppwfi.
__MIDL__IWiaMiniDrv0062
plDevErrVal [out]
Указывает на расположение памяти, которое получит код состояния для этого метода. Если этот метод возвращает S_OK, то сохраненное значение будет равно нулю. В противном случае код ошибки для мини-driver будет храниться в расположении, на которое указывает этот параметр.
__MIDL__IWiaMiniDrv0063
ppwfi [out, необязательный]
Указывает на расположение памяти, которое получит адрес первого элемента массива WIA_FORMAT_INFO структур.
Возвращаемое значение
При успешном выполнении метод должен возвращать S_OK и очищать значение ошибки устройства, указываемое на plDevErrVal. Если этот метод вызывается для элементов, которые не содержат никаких данных, он должен возвращать E_INVALIDARG. Если метод завершается ошибкой, он должен вернуть стандартный код ошибки COM и поместить значение кода ошибки для мини-driver в память, на которую указывает plDevErrVal.
Значение, указываемое plDevErrVal, можно преобразовать в строку путем вызова IWiaMiniDrv::d rvGetDeviceErrorStr.
Замечания
Этот метод создает массив структур WIA_FORMAT_INFO, описывающих типы носителей и форматы изображений, поддерживаемые аппаратным устройством WIA. Для каждого элемента в массиве тип носителя может быть одним из TYMED_CALLBACK, TYMED_MULTIPAGE_CALLBACK, TYMED_FILEили TYMED_MULTIPAGE_FILE. Типичные значения для формата изображения включают WiaImgFmt_JPEG и WiaImgFmt_BMP, среди прочего. Дополнительные сведения см. в разделе Основные сведения о TYMED и WIA_IPA_FILENAME_EXTENSION.
Мини-driver может определить глобальный массив для хранения WIA_FORMAT_INFO структур или выделить память для массива. Служба WIA не освобождает выделенную память, поэтому мини-driver должен хранить указатель на память в контексте элемента драйвера. Мини-driver может освободить эту память в вызове IWiaMiniDrv::d rvFreeDrvItemContext.
Требования
| Требование | Ценность |
|---|---|
| целевая платформа | Настольный |
| заголовка | wiamindr_lh.h (включить Wiamindr.h) |