Структура SCANINFO (wiamicro.h)

Структура SCANINFO используется для хранения и передачи информации о получении сканирования. Драйвер WIA Flatbed считывает значения из структуры SCANINFO, но никогда не записывает значения. За задание значений для членов SCANINFO отвечает микродрайвер.

Синтаксис

typedef struct _SCANINFO {
  LONG       ADF;
  LONG       TPA;
  LONG       Endorser;
  LONG       OpticalXResolution;
  LONG       OpticalYResolution;
  LONG       BedWidth;
  LONG       BedHeight;
  RANGEVALUE IntensityRange;
  RANGEVALUE ContrastRange;
  LONG       SupportedCompressionType;
  LONG       SupportedDataTypes;
  LONG       WidthPixels;
  LONG       WidthBytes;
  LONG       Lines;
  LONG       DataType;
  LONG       PixelBits;
  LONG       Intensity;
  LONG       Contrast;
  LONG       Xresolution;
  LONG       Yresolution;
  SCANWINDOW Window;
  LONG       DitherPattern;
  LONG       Negative;
  LONG       Mirror;
  LONG       AutoBack;
  LONG       ColorDitherPattern;
  LONG       ToneMap;
  LONG       Compression;
  LONG       RawDataFormat;
  LONG       RawPixelOrder;
  LONG       bNeedDataAlignment;
  LONG       DelayBetweenRead;
  LONG       MaxBufferSize;
  HANDLE     DeviceIOHandles[MAX_IO_HANDLES];
  LONG       lReserved[MAX_RESERVED];
  VOID       *pMicroDriverContext;
} SCANINFO, *PSCANINFO;

Члены

ADF

Указывает, поддерживает ли сканер автоматическую подавку документов (ADF). Этот элемент может иметь одно из следующих значений:

Значение	Значение
0	Сканер не поддерживает ADF.
1	Сканер поддерживает ADF.
2	Сканер поддерживает ADF с возможностью дуплексного режима.

TPA

Указывает, поддерживает ли сканер TPA (TransParency Adapter). Значение может быть следующим:

0 — не поддерживается

1 — поддерживается

Endorser

Указывает, имеет ли сканер возможности индоссывателя. Значение может быть следующим:

0 — не поддерживается

1 — поддерживается

OpticalXResolution

Задает параметр горизонтального разрешения на дюйм для оптики сканера.

OpticalYResolution

Задает параметр вертикального разрешения на дюйм для оптики сканера.

BedWidth

Указывает ширину кровати сканера в тысячных долях дюйма.

BedHeight

Указывает высоту кровати сканера в тысячных долях дюйма.

IntensityRange

Задает значения диапазона интенсивности и яркости сканера.

ContrastRange

Задает значения диапазона контрастности сканера.

SupportedCompressionType

Задает значение маски поддерживаемых типов сжатия. Нулевое значение указывает, что типы сжатия не поддерживаются.

SupportedDataTypes

Задает значение маски поддерживаемых типов данных. Нулевое значение указывает, что типы данных не поддерживаются. Этот элемент может быть побитовой ИЛИ следующего.

Значение	Значение
SUPPORT_BW	Изображение имеет черно-белый размер 1 бит на пиксель.
SUPPORT_COLOR	Изображение имеет цвет 24 бита на пиксель.
SUPPORT_GRAYSCALE	Изображение имеет 8 бит на пиксель в оттенках серого.

WidthPixels

Задает ширину текущего изображения в пикселях.

WidthBytes

Задает ширину текущего изображения в байтах.

Lines

Указывает высоту текущего изображения в пикселях.

DataType

Указывает текущий набор типов данных текущего изображения. Для этого элемента можно задать одно из следующих элементов.

Значение	Значение
WIA_DATA_COLOR	Драйвер поддерживает цвет 24 бита на пиксель.
WIA_DATA_COLOR_DITHER	Это значение не поддерживается в драйвере WIA Flatbed.
WIA_DATA_COLOR_THRESHOLD	Это значение не поддерживается в драйвере WIA Flatbed.
WIA_DATA_DITHER	Это значение не поддерживается в драйвере WIA Flatbed.
WIA_DATA_GRAYSCALE	Драйвер поддерживает 8 бит на пиксель в оттенках серого.
WIA_DATA_THRESHOLD	Драйвер поддерживает черно-белый 1 бит на пиксель.

PixelBits

Задает текущее значение битовой глубины текущего изображения.

Intensity

Указывает текущий параметр интенсивности и яркости сканера.

Contrast

Задает текущий параметр контрастности сканера.

Xresolution

Задает параметр горизонтального разрешения на дюйм для оптики сканера.

Yresolution

Задает параметр вертикального разрешения на дюйм для оптики сканера.

Window

Задает текущие параметры окна проверки.

DitherPattern

Указывает шаблон литейного сканера.

Negative

Указывает, включено или выключено отрицательное значение. Значение может быть следующим:

0 — выкл.

1 – в

Mirror

Указывает, включена или отключена зеркало. Значение может быть следующим:

0 — выкл.

1 – в

AutoBack

Указывает, включена или отключена функция автозапуска. Значение может быть следующим:

0 — выкл.

1 – в

ColorDitherPattern

Зарезервировано. Задайте нулевое значение.

ToneMap

Зарезервировано. Задайте нулевое значение.

Compression

Указывает, включено или отключено сжатие для сканера. Значение может быть следующим:

0 — выкл.

1 – в

RawDataFormat

Задает формат необработанных данных для средства проверки. Значение может быть следующим:

0 — упакованные данные

1 — планарные данные

RawPixelOrder

Задает порядок в пикселях для сканера. Значение может быть следующим:

0 — RGB

1 — BGR

bNeedDataAlignment

Указывает, требуется ли выравнивание данных для сканера. Значение может быть следующим:

0 — false

1 — true

DelayBetweenRead

Указывает временную задержку в миллисекундах между вызовами функции сканирования , которую может поддерживать сканер.

MaxBufferSize

Указывает максимальный размер буфера в сканере.

DeviceIOHandles[MAX_IO_HANDLES]

Указывает массив дескрипторов ввода-вывода устройства, необходимых для взаимодействия с устройством.

lReserved[MAX_RESERVED]

Задает массив зарезервированных битов.

pMicroDriverContext

Указывает на контекст микродрайвера. Микродрайвер выделяет буфер, на который указывает этот элемент. Буфер должен быть выделен в CMD_INITIALIZE и освобожден в CMD_UNINITIALIZE. (См. раздел Обязательные команды.) Драйвер WIA Flatbed ничего не знает об этом указателе и, следовательно, не изменяет память, на которую указывает этот элемент.

Комментарии

Эта структура используется в качестве параметра в функциях SetPixelWindow и Scan микроdriver.

Требования

Требование	Значение
Заголовок	wiamicro.h (включая Wiamicro.h)

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

Сканирования

SetPixelWindow