SCANINFO-Struktur (wiamicro.h)
Die SCANINFO-Struktur wird verwendet, um Informationen zu einer Scanakquisition zu speichern und zu kommunizieren. Der WIA-Flachbetttreiber liest Werte aus der SCANINFO-Struktur, schreibt aber nie Werte. Es liegt in der Verantwortung des Microdrivers, Werte für die SCANINFO-Member festzulegen.
Syntax
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;
Member
ADF
Gibt an, ob der Scanner einen automatischen Dokumenteinzug (ADF) unterstützt. Dieser Member kann einer der folgenden Werte sein:
| Wert | Bedeutung |
|---|---|
| 0 | Der Scanner unterstützt keine ADF. |
| 1 | Der Scanner unterstützt eine ADF. |
| 2 | Der Scanner unterstützt eine ADF mit Duplexfunktion. |
TPA
Gibt an, ob der Scanner TPA (TransParency Adapter) unterstützt. Der Wert kann Folgendes sein:
0 – nicht unterstützt
1 – unterstützt
Endorser
Gibt an, ob der Scanner über Unterstützungsfunktionen verfügt. Der Wert kann Folgendes sein:
0 – nicht unterstützt
1 – unterstützt
OpticalXResolution
Gibt die horizontale dpi-Einstellung der Scanneroptik an.
OpticalYResolution
Gibt die vertikale dpi-Einstellung der Scanneroptik an.
BedWidth
Gibt die Bettbreite des Scanners in tausendstel Zoll an.
BedHeight
Gibt die Betthöhe des Scanners in tausendstel Zoll an.
IntensityRange
Gibt die Werte der Intensität/Helligkeit des Scanners an.
ContrastRange
Gibt die Kontrastbereichswerte des Scanners an.
SupportedCompressionType
Gibt einen Maskenwert der unterstützten Komprimierungstypen an. Der Wert null gibt an, dass keine Komprimierungstypen unterstützt werden.
SupportedDataTypes
Gibt einen Maskenwert der unterstützten Datentypen an. Der Wert 0 gibt an, dass keine Datentypen unterstützt werden. Bei diesem Member kann es sich um den bitweisen OR der folgenden Elemente handelt.
| Wert | Bedeutung |
|---|---|
| SUPPORT_BW | Das Bild ist 1 Bit pro Pixel schwarz und weiß. |
| SUPPORT_COLOR | Das Bild hat eine Farbe von 24 Bit pro Pixel. |
| SUPPORT_GRAYSCALE | Das Bild ist eine Graustufe von 8 Bit pro Pixel. |
WidthPixels
Gibt die Breite des aktuellen Bilds in Pixel an.
WidthBytes
Gibt die Breite des aktuellen Images in Bytes an.
Lines
Gibt die Höhe des aktuellen Bilds in Pixel an.
DataType
Gibt den aktuellen Datentypsatz des aktuellen Images an. Dieses Element kann auf eine der folgenden Elemente festgelegt werden.
| Wert | Bedeutung |
|---|---|
| WIA_DATA_COLOR | Der Treiber unterstützt 24 Bit-pro-Pixel-Farbe. |
| WIA_DATA_COLOR_DITHER | Dieser Wert wird im WIA-Flatbed-Treiber nicht unterstützt. |
| WIA_DATA_COLOR_THRESHOLD | Dieser Wert wird im WIA-Flatbed-Treiber nicht unterstützt. |
| WIA_DATA_DITHER | Dieser Wert wird im WIA-Flatbed-Treiber nicht unterstützt. |
| WIA_DATA_GRAYSCALE | Der Treiber unterstützt 8 Bit-pro-Pixel-Graustufen. |
| WIA_DATA_THRESHOLD | Der Treiber unterstützt 1 Bit pro Pixel Schwarzweiß. |
PixelBits
Gibt die aktuelle Bittiefeeinstellung des aktuellen Bilds an.
Intensity
Gibt die aktuelle Intensitäts-/Helligkeitseinstellung des Scanners an.
Contrast
Gibt die aktuelle Kontrasteinstellung des Scanners an.
Xresolution
Gibt die horizontale dpi-Einstellung der Scanneroptik an.
Yresolution
Gibt die vertikale dpi-Einstellung der Scanneroptik an.
Window
Gibt die aktuellen Einstellungen des Scannerfensters an.
DitherPattern
Gibt das Dithermuster des Scanners an.
Negative
Gibt an, ob negativ aktiviert oder deaktiviert ist. Der Wert kann Folgendes sein:
0 – aus
1 – ein
Mirror
Gibt an, ob Spiegel aktiviert oder deaktiviert ist. Der Wert kann Folgendes sein:
0 – aus
1 – ein
AutoBack
Gibt an, ob AutoBack aktiviert oder deaktiviert ist. Der Wert kann Folgendes sein:
0 – aus
1 – ein
ColorDitherPattern
Reserviert. Auf NULL festlegen.
ToneMap
Reserviert. Auf NULL festlegen.
Compression
Gibt an, ob die Komprimierung für den Scanner aktiviert oder deaktiviert ist. Der Wert kann Folgendes sein:
0 – aus
1 – ein
RawDataFormat
Gibt das Rohdatenformat für den Scanner an. Der Wert kann Folgendes sein:
0 – Gepackte Daten
1 : Planare Daten
RawPixelOrder
Gibt die Pixelreihenfolge für den Scanner an. Der Wert kann Folgendes sein:
0 – RGB
1 – BGR
bNeedDataAlignment
Gibt an, ob die Datenausrichtung für den Scanner erforderlich ist. Der Wert kann Folgendes sein:
0 – false
1 – true
DelayBetweenRead
Gibt die Zeitverzögerung in Millisekunden zwischen Aufrufen der Scanfunktion an, die der Scanner unterstützen kann.
MaxBufferSize
Gibt die maximale Puffergröße im Scanner an.
DeviceIOHandles[MAX_IO_HANDLES]
Gibt ein Array von Geräte-E/A-Handles an, die für die Gerätekommunikation erforderlich sind.
lReserved[MAX_RESERVED]
Gibt ein Array reservierter Bits an.
pMicroDriverContext
Verweist auf den Kontext des Microdrivers. Der Microdriver ordnet den Puffer zu, auf den dieses Element verweist. Der Puffer sollte in CMD_INITIALIZE zugeordnet und in CMD_UNINITIALIZE freigegeben werden. (Siehe Erforderliche Befehle.) Der WIA Flatbed-Treiber weiß nichts von diesem Zeiger und ändert daher nicht den Speicher, auf den dieses Element verweist.
Hinweise
Diese Struktur wird als Parameter in den Funktionen SetPixelWindow und Scan des Microdrivers verwendet.
Anforderungen
| Anforderung | Wert |
|---|---|
| Header | wiamicro.h (wiamicro.h einschließen) |