Struktur SCANINFO (wiamicro.h)
Struktur SCANINFO digunakan untuk menyimpan dan mengomunikasikan informasi tentang akuisisi pemindaian. Driver Flatbed WIA membaca nilai dari struktur SCANINFO, tetapi tidak pernah menulis nilai. Merupakan tanggung jawab microdriver untuk menetapkan nilai bagi anggota SCANINFO.
Sintaks
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;
Anggota
ADF
Menunjukkan apakah pemindai mendukung pengumpan dokumen otomatis (ADF). Anggota ini bisa menjadi salah satu nilai berikut:
| Nilai | Makna |
|---|---|
| 0 | Pemindai tidak mendukung ADF. |
| 1 | Pemindai mendukung ADF. |
| 2 | Pemindai mendukung ADF dengan kemampuan dupleks. |
TPA
Menunjukkan apakah pemindai mendukung TPA (TransParency Adapter). Nilainya dapat berupa:
0 - tidak didukung
1 - didukung
Endorser
Menunjukkan apakah pemindai memiliki kemampuan yang mendukung. Nilainya dapat berupa:
0 - tidak didukung
1 - didukung
OpticalXResolution
Menentukan pengaturan dpi horizontal dari optik pemindai.
OpticalYResolution
Menentukan pengaturan dpi vertikal optik pemindai.
BedWidth
Menentukan lebar tempat tidur pemindai dalam seribu inci.
BedHeight
Menentukan tinggi tempat tidur pemindai dalam seribu inci.
IntensityRange
Menentukan nilai rentang intensitas/kecerahan pemindai.
ContrastRange
Menentukan nilai rentang kontras pemindai.
SupportedCompressionType
Menentukan nilai masker dari jenis kompresi yang didukung. Nilai nol menunjukkan bahwa tidak ada jenis kompresi yang didukung.
SupportedDataTypes
Menentukan nilai masker dari jenis data yang didukung. Nilai nol menunjukkan bahwa tidak ada jenis data yang didukung. Anggota ini bisa menjadi bitwise ATAU dari berikut ini.
| Nilai | Makna |
|---|---|
| SUPPORT_BW | Gambarnya adalah hitam dan putih 1 bit per piksel. |
| SUPPORT_COLOR | Gambarnya berwarna 24 bit per piksel. |
| SUPPORT_GRAYSCALE | Gambarnya adalah skala abu-abu 8 bit per piksel. |
WidthPixels
Menentukan lebar gambar saat ini dalam piksel.
WidthBytes
Menentukan lebar gambar saat ini dalam byte.
Lines
Menentukan tinggi gambar saat ini dalam piksel.
DataType
Menentukan kumpulan tipe data saat ini dari gambar saat ini. Anggota ini dapat diatur ke salah satu hal berikut ini.
| Nilai | Makna |
|---|---|
| WIA_DATA_COLOR | Driver mendukung warna 24 bit per piksel. |
| WIA_DATA_COLOR_DITHER | Nilai ini tidak didukung di driver Flatbed WIA. |
| WIA_DATA_COLOR_THRESHOLD | Nilai ini tidak didukung di driver Flatbed WIA. |
| WIA_DATA_DITHER | Nilai ini tidak didukung di driver Flatbed WIA. |
| WIA_DATA_GRAYSCALE | Driver mendukung skala abu-abu 8 bit per piksel. |
| WIA_DATA_THRESHOLD | Driver mendukung 1 bit-per-piksel hitam dan putih. |
PixelBits
Menentukan pengaturan kedalaman bit saat ini dari gambar saat ini.
Intensity
Menentukan pengaturan intensitas/kecerahan pemindai saat ini.
Contrast
Menentukan pengaturan kontras pemindai saat ini.
Xresolution
Menentukan pengaturan dpi horizontal dari optik pemindai.
Yresolution
Menentukan pengaturan dpi vertikal optik pemindai.
Window
Menentukan setelan jendela pemindai saat ini.
DitherPattern
Menentukan pola dither pemindai.
Negative
Menentukan apakah negatif aktif atau nonaktif. Nilainya dapat berupa:
0 - nonaktif
1 - aktif
Mirror
Menentukan apakah cermin aktif atau nonaktif. Nilainya dapat berupa:
0 - nonaktif
1 - aktif
AutoBack
Menentukan apakah AutoBack aktif atau nonaktif. Nilainya dapat berupa:
0 - nonaktif
1 - aktif
ColorDitherPattern
Dicadangkan. Atur ke nol.
ToneMap
Dicadangkan. Atur ke nol.
Compression
Menentukan apakah pemadatan aktif atau nonaktif untuk pemindai. Nilainya dapat berupa:
0 - nonaktif
1 - aktif
RawDataFormat
Menentukan format data mentah untuk pemindai. Nilainya dapat berupa:
0 - data yang dikemas
1 - data planar
RawPixelOrder
Menentukan urutan piksel untuk pemindai. Nilainya dapat berupa:
0 - RGB
1 - BGR
bNeedDataAlignment
Menentukan apakah perataan data diperlukan untuk pemindai. Nilainya dapat berupa:
0 - false
1 - benar
DelayBetweenRead
Menentukan penundaan waktu dalam milidetik antara panggilan fungsi Pemindaian yang dapat didukung pemindai.
MaxBufferSize
Menentukan ukuran buffer maksimum dalam pemindai.
DeviceIOHandles[MAX_IO_HANDLES]
Menentukan array handel I/O perangkat yang diperlukan untuk komunikasi perangkat.
lReserved[MAX_RESERVED]
Menentukan array bit yang dipesan.
pMicroDriverContext
Menunjuk ke konteks microdriver. Microdriver mengalokasikan buffer yang diarahkan oleh anggota ini. Buffer harus dialokasikan di CMD_INITIALIZE, dan dibebaskan dalam CMD_UNINITIALIZE. (Lihat Perintah yang Diperlukan.) Driver Flatbed WIA tidak tahu apa-apa tentang penunjuk ini, dan karenanya tidak akan mengubah memori yang ditujukan oleh anggota ini.
Keterangan
Struktur ini digunakan sebagai parameter dalam fungsi SetPixelWindow, dan Scan microdriver.
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Header | wiamicro.h (termasuk Wiamicro.h) |