функция wiasGetImageInformation (wiamdef.h)

Функция wiasGetImageInformation извлекает сведения о контексте передачи из элемента.

Синтаксис

HRESULT wiasGetImageInformation(
  [in]      BYTE                      *pWiasContext,
            LONG                      lFlags,
  [in, out] PMINIDRV_TRANSFER_CONTEXT pmdtc
);

Параметры

[in] pWiasContext

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

lFlags

Указывает операционные флаги. В настоящее время определен только следующий флаг:

Флаг	Значение
WIAS_INIT_CONTEXT	Инициализация структуры MINIDRV_TRANSFER_CONTEXT.

[in, out] pmdtc

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

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

При успешном выполнении функция возвращает S_OK.

Если функция завершается ошибкой, она возвращает стандартную ошибку COM или один из кодов ошибок WIA .

Замечания

Эта функция использует структуру MINIDRV_TRANSFER_CONTEXT для вычисления размеров изображений элементов и заголовков элементов. Кроме того, он может при необходимости заполнить заголовок изображения, если формат изображения требует заголовка данных. Заголовок будет скопирован в буфер, если pTransferBuffer член структуры MINIDRV_TRANSFER_CONTEXT не NULL. При использовании форматов изображений (например, JPEG), не имеющих заголовка, размер заголовка в lHeaderSize член структуры MINIDRV_TRANSFER_CONTEXT сообщается как нулевой.

Для форматов изображений, где фактический окончательный размер изображения не известен до тех пор, пока после получения данных, как и с многопажными форматами TIFF и сжатыми форматами, lItemSize элемент структуры MINIDRV_TRANSFER_CONTEXT сообщается как ноль. Элемент lImageSize сообщается как размер в байтах несжатого изображения на одной странице.

Если WIAS_INIT_CONTEXT указан в параметре lFlags, MINIDRV_TRANSFER_CONTEXT структура, на которую указывает параметр pmdtc, заполняется сведениями, производными от свойств изображения элемента. Этот флаг следует использовать при выделении нового контекста мини-driver.

Требования

Требование	Ценность
целевая платформа	Настольный
заголовка	wiamdef.h (включая Wiamdef.h)
библиотеки	Wiaservc.lib
DLL	Wiaservc.dll

См. также

MINIDRV_TRANSFER_CONTEXT