Struttura SCANINFO (wiamicro.h)
La struttura SCANINFO viene utilizzata per archiviare e comunicare informazioni su un'acquisizione di analisi. Il driver WIA Flatbed legge i valori dalla struttura SCANINFO, ma non scrive mai valori. È responsabilità del microdriver impostare i valori per i membri SCANINFO.
Sintassi
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;
Members
ADF
Indica se lo scanner supporta un feeder di documenti automatico( ADF). Questo membro può essere uno dei valori seguenti:
| Valore | Significato |
|---|---|
| 0 | Lo scanner non supporta un'ADF. |
| 1 | Lo scanner supporta un'ADF. |
| 2 | Lo scanner supporta un'ADF con funzionalità duplex. |
TPA
Indica se lo scanner supporta TPA (TransParency Adapter). Il valore può essere:
0 - non supportato
1 - Supportato
Endorser
Indica se lo scanner ha funzionalità di approvazione. Il valore può essere:
0 - non supportato
1 - Supportato
OpticalXResolution
Specifica l'impostazione dpi orizzontale dell'ottica dello scanner.
OpticalYResolution
Specifica l'impostazione dpi verticale dell'ottica dello scanner.
BedWidth
Specifica la larghezza del letto dello scanner in millesimi di pollice.
BedHeight
Specifica l'altezza del letto dello scanner in millesimi di pollice.
IntensityRange
Specifica i valori dell'intervallo di intensità/luminosità dello scanner.
ContrastRange
Specifica i valori dell'intervallo di contrasto dello scanner.
SupportedCompressionType
Specifica un valore mask dei tipi di compressione supportati. Il valore zero indica che non sono supportati tipi di compressione.
SupportedDataTypes
Specifica un valore mask dei tipi di dati supportati. Il valore zero indica che non sono supportati tipi di dati. Questo membro può essere l'OR bit per bit del seguente.
| Valore | Significato |
|---|---|
| SUPPORT_BW | L'immagine è a 1 bit per pixel nero e bianco. |
| SUPPORT_COLOR | L'immagine è a 24 bit per pixel. |
| SUPPORT_GRAYSCALE | L'immagine è a 8 bit per pixel in scala di grigi. |
WidthPixels
Specifica la larghezza dell'immagine corrente in pixel.
WidthBytes
Specifica la larghezza dell'immagine corrente in byte.
Lines
Specifica l'altezza dell'immagine corrente in pixel.
DataType
Specifica il set di tipi di dati corrente dell'immagine corrente. Questo membro può essere impostato su uno dei seguenti.
| Valore | Significato |
|---|---|
| WIA_DATA_COLOR | Il driver supporta il colore a 24 bit per pixel. |
| WIA_DATA_COLOR_DITHER | Questo valore non è supportato nel driver WIA Flatbed. |
| WIA_DATA_COLOR_THRESHOLD | Questo valore non è supportato nel driver WIA Flatbed. |
| WIA_DATA_DITHER | Questo valore non è supportato nel driver WIA Flatbed. |
| WIA_DATA_GRAYSCALE | Il driver supporta la scala di grigi a 8 bit per pixel. |
| WIA_DATA_THRESHOLD | Il driver supporta 1 bit per pixel nero e bianco. |
PixelBits
Specifica l'impostazione della profondità di bit corrente dell'immagine corrente.
Intensity
Specifica l'impostazione corrente di intensità/luminosità dello scanner.
Contrast
Specifica l'impostazione di contrasto corrente dello scanner.
Xresolution
Specifica l'impostazione dpi orizzontale dell'ottica dello scanner.
Yresolution
Specifica l'impostazione dpi verticale dell'ottica dello scanner.
Window
Specifica le impostazioni correnti della finestra dello scanner.
DitherPattern
Specifica il modello dither dello scanner.
Negative
Specifica se il valore negativo è attivato o disattivato. Il valore può essere:
0 - disattivato
1 - on
Mirror
Specifica se il mirror è attivato o disattivato. Il valore può essere:
0 - disattivato
1 - on
AutoBack
Specifica se AutoBack è attivato o disattivato. Il valore può essere:
0 - disattivato
1 - on
ColorDitherPattern
Riservato. Imposta su zero.
ToneMap
Riservato. Imposta su zero.
Compression
Specifica se la compressione è attivata o disattivata per lo scanner. Il valore può essere:
0 - disattivato
1 - on
RawDataFormat
Specifica il formato dati non elaborato per lo scanner. Il valore può essere:
0 - Dati compressi
1 - Dati planari
RawPixelOrder
Specifica l'ordine dei pixel per lo scanner. Il valore può essere:
0 - RGB
1 - BGR
bNeedDataAlignment
Specifica se l'allineamento dei dati è necessario per lo scanner. Il valore può essere:
0 - false
1 - true
DelayBetweenRead
Specifica il ritardo di tempo in millisecondi tra le chiamate di funzione scan che lo scanner può supportare.
MaxBufferSize
Specifica le dimensioni massime del buffer nello scanner.
DeviceIOHandles[MAX_IO_HANDLES]
Specifica una matrice di handle di I/O del dispositivo necessari per la comunicazione del dispositivo.
lReserved[MAX_RESERVED]
Specifica una matrice di bit riservati.
pMicroDriverContext
Punta al contesto del microdriver. Il microdriver alloca il buffer a cui punta questo membro. Il buffer deve essere allocato in CMD_INITIALIZE e liberato in CMD_UNINITIALIZE. Vedere Comandi obbligatori. Il driver WIA Flatbed non conosce nulla di questo puntatore e quindi non altererà la memoria puntata da questo membro.
Commenti
Questa struttura viene usata come parametro nelle funzioni SetPixelWindow e Scan del microdriver.
Requisiti
| Requisito | Valore |
|---|---|
| Intestazione | wiamicro.h (includere Wiamicro.h) |