Функция wiasGetImageInformation (wiamdef.h)
Функция wiasGetImageInformation извлекает сведения о контексте передачи из элемента.
Синтаксис
HRESULT wiasGetImageInformation(
[in] BYTE *pWiasContext,
LONG lFlags,
[in, out] PMINIDRV_TRANSFER_CONTEXT pmdtc
);
Параметры
[in] pWiasContext
Указатель на контекст элемента WIA.
lFlags
Задает рабочие флаги. В настоящее время определен только следующий флаг:
| Flag | Значение |
|---|---|
| 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 указывается как размер в байтах несжатого изображения на одной странице.
Если в параметре lFlags указано WIAS_INIT_CONTEXT, структура MINIDRV_TRANSFER_CONTEXT, на которую указывает параметр pmdtc , заполняется сведениями, производными от свойств изображения элемента. Этот флаг следует использовать, когда мини-диск выделил новый контекст.
Требования
| Требование | Значение |
|---|---|
| Целевая платформа | Персональный компьютер |
| Верхняя часть | wiamdef.h (включая Wiamdef.h) |
| Библиотека | Wiaservc.lib |
| DLL | Wiaservc.dll |