SCANINFO 結構 (wiamicro.h)
SCANINFO 結構可用來儲存和傳達掃描擷取的相關信息。 WIA Flatbed Driver 會從 SCANINFO 結構讀取值,但永遠不會寫入值。 Microdriver 負責設定 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
指定掃描器的任一模式。
Negative
指定負值是開啟還是關閉。 此值可以是:
0 - 關閉
1 - 開啟
Mirror
指定鏡像是否開啟或關閉。 此值可以是:
0 - 關閉
1 - 開啟
AutoBack
指定 AutoBack 是否開啟或關閉。 此值可以是:
0 - 關閉
1 - 開啟
ColorDitherPattern
保留的。 設定為零。
ToneMap
保留的。 設定為零。
Compression
指定掃描器的壓縮是否開啟或關閉。 此值可以是:
0 - 關閉
1 - 開啟
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
指向 microdriver 的內容。 microdriver 會配置這個成員所指向的緩衝區。 緩衝區應該配置在 CMD_INITIALIZE 中,並在 CMD_UNINITIALIZE 中釋放。 (請參閱 必要 Commands.) WIA Flatbed 驅動程式不知道此指標,因此不會改變此成員所指向的記憶體。
備註
這個結構會當做 microdriver 的 SetPixelWindow 和 Scan 函式中的參數使用。
規格需求
需求 | 值 |
---|---|
標頭 | wiamicro.h (包括 Wiamicro.h) |