scanINFO 结构 (wiamicro.h)
SCANINFO 结构用于存储和传达有关扫描获取的信息。 WIA 平面驱动程序从 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 适配器) 。 值可以是:
0 - 不支持
1 - 支持
Endorser
指示扫描程序是否具有背书人功能。 值可以是:
0 - 不支持
1 - 支持
OpticalXResolution
指定扫描仪光学设备的水平 dpi 设置。
OpticalYResolution
指定扫描仪光学的垂直 dpi 设置。
BedWidth
指定扫描仪的床宽(以千分之一英寸为单位)。
BedHeight
指定扫描仪的床高度(以千分之一英寸为单位)。
IntensityRange
指定扫描仪的强度/亮度范围值。
ContrastRange
指定扫描仪的对比度范围值。
SupportedCompressionType
指定支持的压缩类型的掩码值。 值为零表示不支持任何压缩类型。
SupportedDataTypes
指定支持的数据类型的掩码值。 值为零表示不支持任何数据类型。 此成员可以是以下项的按位 OR。
值 | 含义 |
---|---|
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
指定扫描仪光学设备的水平 dpi 设置。
Yresolution
指定扫描仪光学的垂直 dpi 设置。
Window
指定当前扫描程序窗口设置。
DitherPattern
指定扫描程序的 dither 模式。
Negative
指定负值是打开还是关闭。 值可以是:
0 - off
1 - on
Mirror
指定镜像是打开还是关闭。 值可以是:
0 - off
1 - on
AutoBack
指定自动返回是打开还是关闭。 值可以是:
0 - off
1 - on
ColorDitherPattern
保留。 设置为零。
ToneMap
保留。 设置为零。
Compression
指定扫描程序是打开还是关闭压缩。 值可以是:
0 - off
1 - on
RawDataFormat
指定扫描程序的原始数据格式。 值可以是:
0 - 已打包数据
1 - 平面数据
RawPixelOrder
指定扫描仪的像素顺序。 值可以是:
0 - RGB
1 - BGR
bNeedDataAlignment
指定扫描程序是否需要数据对齐。 值可以是:
0 - false
1 - true
DelayBetweenRead
指定扫描程序可以支持的 Scan 函数调用之间的时间延迟(以毫秒为单位)。
MaxBufferSize
指定扫描程序中的最大缓冲区大小。
DeviceIOHandles[MAX_IO_HANDLES]
指定设备通信所需的设备 I/O 句柄数组。
lReserved[MAX_RESERVED]
指定保留位的数组。
pMicroDriverContext
指向微驱动程序的上下文。 微驱动程序分配此成员指向的缓冲区。 缓冲区应在 CMD_INITIALIZE 中分配,并在 CMD_UNINITIALIZE 中释放。 (请参阅 所需的命令。) WIA Flatbed 驱动程序对此指针一无所知,因此不会更改此成员指向的内存。
注解
此结构用作微驱动程序的 SetPixelWindow 和 Scan 函数中的参数。
要求
要求 | 值 |
---|---|
Header | wiamicro.h (包括 Wiamicro.h) |