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:

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.

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.

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

Weitere Informationen

Scan

SetPixelWindow