SCANINFO-Struktur (wiamicro.h)
Die SCANINFO-Struktur wird verwendet, um Informationen über einen Scan-Kauf zu speichern und zu kommunizieren. Der WIA Flatbed Driver liest Werte aus der SCANINFO-Struktur, schreibt aber niemals Werte. Es liegt in der Verantwortung des Microdrivers, Werte für die SCANINFO-Mitglieder 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;
Angehörige
ADF
Gibt an, ob der Scanner einen automatischen Dokumentfeeder (ADF) unterstützt. Dieses Element 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 des Intensitäts-/Helligkeitsbereichs des Scanners an.
ContrastRange
Gibt die Kontrastbereichswerte des Scanners an.
SupportedCompressionType
Gibt einen Maskenwert der unterstützten Komprimierungstypen an. Ein Wert von Null gibt an, dass keine Komprimierungstypen unterstützt werden.
SupportedDataTypes
Gibt einen Maskenwert der unterstützten Datentypen an. Ein Wert von Null gibt an, dass keine Datentypen unterstützt werden. Dieses Element kann der bitweise OR der folgenden Sein.
| Wert | Bedeutung |
|---|---|
| SUPPORT_BW | Das Bild ist 1 Bit pro Pixel schwarzweiß. |
| SUPPORT_COLOR | Das Bild ist 24 Bit pro Pixel. |
| SUPPORT_GRAYSCALE | Das Bild ist 8 Bit pro Pixel Graustufen. |
WidthPixels
Gibt die Breite des aktuellen Bilds in Pixeln an.
WidthBytes
Gibt die Breite des aktuellen Bilds in Byte an.
Lines
Gibt die Höhe des aktuellen Bilds in Pixel an.
DataType
Gibt den aktuellen Datentypsatz des aktuellen Bilds an. Dieses Element kann auf einen 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 Einstellung für Intensität/Helligkeit 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 die Spiegelung 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 festgelegt.
ToneMap
Reserviert. Auf Null festgelegt.
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 – verpackte Daten
1 – Planardaten
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 - wahr
DelayBetweenRead
Gibt die Zeitverzögerung in Millisekunden zwischen Scan- Funktionsaufrufen 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 Mikrodriver weist den Puffer zu, auf den dieses Element verweist. Der Puffer sollte in CMD_INITIALIZE zugewiesen und in CMD_UNINITIALIZE freigegeben werden. (Siehe Erforderliche Befehle.) Der WIA Flatbed-Treiber kennt nichts von diesem Zeiger und ändert daher nicht den Speicher, auf den dieses Element verweist.
Bemerkungen
Diese Struktur wird als Parameter in den SetPixelWindow-von Microdriver und Scan--Funktionen verwendet.
Anforderungen
| Anforderung | Wert |
|---|---|
| Header- | wiamicro.h (include Wiamicro.h) |