Freigeben über

Eigenschaftenkonstanten des Scannergeräts

  • Artikel

Windows Image Acquisition (WIA)-Hardwaregeräte verfügen über Eigenschaftswerte, die in der Windows-Registrierung gespeichert sind. Weitere Informationen finden Sie unter Allgemeine Geräteeigenschaftenkonstanten. Die folgenden Geräteeigenschaftenkonstanten mit ihren zugeordneten Zeichenfolgen sind spezifisch für digitale Bildscanner.

Das Präfix "WIA_DPS_" gibt eine Geräteeigenschaft für Scannergeräte an und ist die in C/C++ verwendete Namenskonvention. Zu Skriptzwecken verwenden diese Konstanten das Präfix "ScannerDevice" und sind Teil des aufgezählten WiaItemPropertyId-Typs . Der entsprechende Membername aus dieser Skriptaufzählung wird in Klammern neben dem C/C++-Konstantennamen in der folgenden Liste angezeigt.

Konstante/Wert BESCHREIBUNG
WIA_DPS_DEVICE_ID
ScannerDeviceDeviceId
 Hinweis:
Diese Eigenschaft wird nur unter Windows Vista und höher unterstützt.


Enthält eine eindeutige Funktion instance Bezeichner für ein Webdienstscannergerät. Dieser Bezeichner stellt den Webdienst auf dem Scannergerät dar, mit dem der WIA-Minitreiber kommuniziert. Es sollten keine Annahmen über die Form dieses Bezeichners getroffen werden. Der WIA-Minitreiber erstellt und verwaltet diese Eigenschaft.
WIA-Anwendungen können den Wert von WIA_DPS_DEVICE_ID verwenden, um mithilfe der Funktionsermittlungs-API die Funktion instance Objekt zu finden, das das in der aktuellen WIA 2.0-Sitzung verwendete Webdienstscannergerät darstellt.
Typ: VT_BSTR, Access: Schreibschutz, Gültige Werte: WIA_PROP_NONE
WIA_DPS_DITHER_PATTERN_DATA
 Reserviert, nicht verwenden.
Typ: VT_I4, Access: Schreibschutz, Gültige Werte: WIA_PROP_NONE
WIA_DPS_DITHER_SELECT
 Reserviert, nicht verwenden.
Typ: VT_I4, Access: Schreibschutz, Gültige Werte: WIA_PROP_NONE
WIA_DPS_DOCUMENT_HANDLING_CAPABILITIES
ScannerDeviceDocumentHandlingCapabilities
 Enthält die Funktionen des Scanners. Der Minidriver erstellt und verwaltet diese Eigenschaft.
Eine Anwendung liest diese Eigenschaft, um zu bestimmen, ob auf dem Scanner ein Flatbed, ein Dokumentzuführungsmodul oder ein Duplexer installiert ist. Diese Eigenschaft wird auch verwendet, um die installierten Features weiter zu definieren.
Typ: VT_I4, Access: Schreibschutz, Gültige Werte: WIA_PROP_NONE
In der folgenden Tabelle werden die Konstanten beschrieben, die nur für Windows 7 gültig sind.
Flags BESCHREIBUNG
AUTO_SOURCE Für den Scanner ist ein automatischer Dokumenthandler installiert.

 

In der folgenden Tabelle werden die Konstanten beschrieben, die nur für Windows 7 und Windows Vista gültig sind.

Flags BESCHREIBUNG
ADVANCED_DUP Das Gerät unterstützt die erweiterte Konfiguration von Duplexscans. Verwenden Sie WIA_IPS_DUPLEX_SETTINGS, um zwischen einfachen und erweiterten Duplexkonfigurationen zu wechseln.
DETECT_FILM_TPA Der Scanner kann erkennen, wann der Transparenz-/Filmadapter zum Scannen bereit ist.
DETECT_STOR Der Scanner kann erkennen, wenn dokumente im internen Speicher vorhanden sind.
FILM_TPA Der Scanner ist mit einem Transparenz-/Filmscan-Adapter ausgestattet.
STOR Der Scanner ist mit einem internen Bildspeichergerät ausgestattet.

 

In der folgenden Tabelle werden die Konstanten beschrieben, die mit Windows XP oder höher gültig sind.

Flags BESCHREIBUNG
DETECT_FEED Der Scanner kann ein Dokument im Feeder erkennen.
DETECT_FLAT Der Scanner kann ein Dokument auf der Flachbettplatte erkennen.
DETECT_SCAN Der Scanner kann ein Dokument im Feed nur durch Scannen erkennen.
DUP Der Scanner verfügt über einen Duplexer.
FEED Für den Scanner ist ein automatischer Dokumenthandler installiert.
FLACH Der Scanner verfügt über eine Flachbettplatte.

 

In der folgenden Tabelle werden die Konstanten beschrieben, die nur für Windows XP gültig sind. Diese Werte sind für Windows 7 und Windows Vista veraltet und sollten nicht verwendet werden.

Flags BESCHREIBUNG
DETECT_DUP Der Scanner kann eine Duplexscananforderung des Benutzers erkennen.
DETECT_DUP_AVAIL Der Scanner kann erkennen, wann der Duplexer installiert ist.
DETECT_FEED_AVAIL Der Scanner kann erkennen, wann der automatische Dokumenteinzug installiert ist.

 
WIA_DPS_DOCUMENT_HANDLING_SELECT
ScannerDeviceDocumentHandlingSelect

Hinweis:
Diese Eigenschaft wird in Windows Vista und höher nicht unterstützt. Verwenden Sie WIA_IPS_DOCUMENT_HANDLING_SELECT.

 

Enthält die aktuelle Quelle und den aktuellen Scanner-Erfassungsmodus. Der Minidriver erstellt und verwaltet diese Eigenschaft.

Eine Anwendung liest diese Eigenschaft, um die aktuelle Erfassungsquelle des Scanners zu ermitteln oder diese Eigenschaft zu schreiben, um die Quelle und den Modus des Scanners festzulegen. Darüber hinaus verwenden Anwendungen diese Eigenschaft, um die Duplexfunktion zu aktivieren und zu deaktivieren.

Typ: VT_I4, Access: Lese-/Schreibzugriff, Gültige Werte: WIA_PROP_FLAG

Die folgende Tabelle enthält die zehn Konstanten, die mit dieser Eigenschaft gültig sind.

Flags BESCHREIBUNG
FEEDER Scannen sie mithilfe des Dokumenteinzugs.
FLACHBETT Scannen Sie mit dem Flachbett.
DUPLEX Überprüfung mithilfe von Duplexvorgängen.
AUTO_ADVANCE Aktiviert die automatische Zuführung des nächsten Dokuments nach einer Überprüfung.
FRONT_FIRST Scannen Sie zuerst die Vorderseite des Dokuments. Dieser Wert ist gültig, wenn DUPLEX festgelegt ist.
BACK_FIRST Scannen Sie zuerst die Rückseite des Dokuments. Dieser Wert ist gültig, wenn DUPLEX festgelegt ist.
FRONT_ONLY Scannen Sie nur die Vorderseite. Dieser Wert ist gültig, wenn DUPLEX festgelegt ist.
BACK_ONLY Scannen Sie nur die Rückseite. Dieser Wert ist gültig, wenn DUPLEX festgelegt ist.
NEXT_PAGE Überprüfen Sie die nächste Seite des Dokuments.
PREFEED Aktivieren Sie den Pre-Feed-Modus. Positionieren Sie das nächste Dokument vor dem Scannen.

 
WIA_DPS_DOCUMENT_HANDLING_STATUS
ScannerDeviceDocumentHandlingStatus

Enthält den aktuellen Zustand des installierten Flachbetts, des Dokumentzuführungsmoduls oder des Duplexers des Scanners. Der Minidriver erstellt und verwaltet diese Eigenschaft.

Eine Anwendung liest diese Eigenschaft, um zu bestimmen, ob das Scannergerät für die Verwendung bereit ist. Dies ist eine ideale Möglichkeit, um zu überprüfen, ob sich Papier im Feeder befindet, bevor ein Bild erworben wird.

Typ: VT_I4, Access: Schreibschutz, Gültige Werte: WIA_PROP_NONE

Die folgende Tabelle enthält die Konstanten, die für diese Eigenschaft gültig sind. Ein Sternchen * gibt an, dass das Flag in Windows Vista oder höher nicht unterstützt wird. Das V-Symbol gibt an, dass das Flag nur in Windows Vista und höher unterstützt wird.

Flags BESCHREIBUNG
FEED_READY Das Flachbett ist einsatzbereit.
FLAT_READY Der Scanner verfügt über ein Dokument auf der Flachbettplatte.
DUP_READY Der Duplexer ist aktiviert und kann verwendet werden.
FLAT_COVER_UP Die flache Bettabdeckung ist oben.
PATH_COVER_UP Der Papierpfad wird verdeckt und verhindert den ordnungsgemäßen Betrieb.
PAPER_JAM Ein Dokument wird im Dokumenteinzug blockiert.
FILM_TPA_READYV Der Transparenzadapter ist installiert und einsatzbereit.
STORAGE_READYV Das interne Speichergerät ist bereit.
STORAGE_FULLV Der Speicher ist voll, es sind keine Uploadvorgänge möglich.
MULTIPLE_FEEDV Es ist eine Mehrfachfeedbedingung aufgetreten (in der Regel mit einem PAPER_JAM).
DEVICE_ATTENTIONV Es liegt ein Fehler vor, der einen Benutzereingriff auf dem Gerät erfordert.
LAMP_ERRV Der Scanner ist aufgrund eines Lampenproblems nicht bereit.

 
WIA_DPS_ENDORSER_CHARACTERS
ScannerDeviceEndorserCharacters

Enthält alle gültigen Zeichen, mit denen eine Anwendung gültige Zeichenfolgen erstellen kann. Ein Endorser ist ein Drucker, der auf einem Scanner installiert ist, der eine TEXTnachricht auf jeder gescannten Seite aufprägt. Der Minitreiber sollte die Einstellung der WIA_DPS_ENDORSER_STRING-Eigenschaft anhand des gültigen Zeichensatzes in dieser Eigenschaft überprüfen. Der Minidriver erstellt und verwaltet diese Eigenschaft.

Typ: VT_BSTR, Access: Schreibschutz, Gültige Werte: WIA_PROP_NONE
WIA_DPS_ENDORSER_STRING
ScannerDeviceEndorserString

Enthält eine Zeichenfolge, die auf jeder Seite, die vom Minitreiber gescannt wird, unterstützt (d. h. gedruckt) werden soll. Eine Anwendung legt diese Eigenschaft mithilfe des gültigen Zeichensatzes fest, der in der WIA_DPS_ENDORSER_CHARACTERS-Eigenschaft gemeldet wird. Der Minitreiber sollte Dokumente nur unterstützen, wenn in dieser Eigenschaft eine Zeichenfolge festgelegt ist. Eine leere Zeichenfolge bedeutet, dass die Unterstützungsfunktion deaktiviert ist.

Da es in der Verantwortung des Fahrers liegt, die Zeichenfolge des Befürworters zu interpretieren, kann Ihr Treiber Sonderzeichen in WIA_DPS_ENDORSER_STRING verwenden. Allerdings würden nur Ihre Anwendungen diese Zeichen verstehen.

Typ: VT_BSTR, Access: Lese-/Schreibzugriff, Gültige Werte: WIA_PROP_NONE

Ein Treiber, der die WIA_DPS_ENDORSER_STRING-Eigenschaft unterstützt, muss die folgende Liste von Token unterstützen.

Token BESCHREIBUNG
$DATE$ Das Datum im Format JJJJ/MM/TT.
$DAY$ Der Tag im Format DD.
$MONTH$ Der Monat des Jahres im Format MM.
$PAGE_COUNT$ Die Anzahl der übertragenen Seiten.
$TIME$ Die Tageszeit im Format HH:MM:SS.
$YEAR$ Das Jahr im Format YYYYY.

 
WIA_DPS_FILTER_SELECT

Reserviert, nicht verwenden.

Typ: VT_I4, Access: Schreibschutz, Gültige Werte: WIA_PROP_NONE
WIA_DPS_GLOBAL_IDENTITY
ScannerDeviceGlobalIdentity

Hinweis:
Diese Eigenschaft wird nur unter Windows Vista und höher unterstützt.

 

Enthält die SOAP-Adresse eines Webdienstscannergeräts. Der WIA 2.0-Minitreiber erstellt und verwaltet diese Eigenschaft.

Typ: VT_BSTR, Access: Schreibschutz, Gültige Werte: WIA_PROP_NONE
WIA_DPS_HORIZONTAL_BED_REGISTRATION
ScannerDeviceHorizontalBedRegistration

Hinweis:
Diese Eigenschaft wird mit Windows Vista und höher nicht unterstützt.

 

Enthält die Registrierung oder horizontale Ausrichtung für Dokumente, die auf dem Flachbett platziert werden. Der Minidriver erstellt und verwaltet diese Eigenschaft.

Typ: VT_I4, Access: Schreibschutz, Gültige Werte: WIA_PROP_NONE

Die folgende Tabelle enthält die drei Konstanten, die mit dieser Eigenschaft gültig sind.

Dauerhaft BESCHREIBUNG
LEFT_JUSTIFIED Das Papier bleibt gerechtfertigt.
ZENTRIERT Das Papier ist zentriert.
RIGHT_JUSTIFIED Das Papier hat recht.

 

Siehe auch

WIA_DPS_VERTICAL_BED_REGISTRATION
WIA_DPS_HORIZONTAL_BED_SIZE
ScannerDeviceHorizontalBedSize

Hinweis:
Diese Eigenschaft wird mit Windows Vista und höher nicht unterstützt. Verwenden Sie WIA_IPS_MAX_HORIZONTAL_SIZE.

 

Gibt die maximale Breite in Tausendstel Zoll an, die in der horizontalen Achse (X) von der Platte eines Flachbettscanners mit der aktuellen Auflösung gescannt wird. Diese Eigenschaft gilt auch für automatische Dokumentzuführungen, die Blätter zum Scannen auf die Platte eines Flachbettscanners verschieben. Diese Eigenschaft ist für Scanner mit einer Platte obligatorisch. Andere Scannertypen implementieren stattdessen die eigenschaft WIA_DPS_HORIZONTAL_SHEET_FEED_SIZE .

Typ: VT_I4, Access: Schreibschutz, Gültige Werte: WIA_PROP_NONE
WIA_DPS_HORIZONTAL_SHEET_FEED_SIZE
ScannerDeviceHorizontalSheetFeedSize

Hinweis:
Diese Eigenschaft wird mit Windows Vista und höher nicht unterstützt. Verwenden Sie WIA_IPS_MAX_HORIZONTAL_SIZE.

 

Gibt die maximale Breite in Tausendstel Zoll an, die in der horizontalen Achse (X) von einem Handheld- oder Blattvorschubscanner mit der aktuellen Auflösung gescannt wird. Diese Eigenschaft gilt auch für automatische Dokumentzuführungen, die scannen, ohne Blätter auf die Platte eines Flachbettscanners zu verschieben. Diese Eigenschaft ist für Blatt-, Bildlauf- und Handscanner obligatorisch.

Typ: VT_I4, Access: Schreibschutz, Gültige Werte: WIA_PROP_NONE
WIA_DPS_MAX_SCAN_TIME
ScannerDeviceMaxScanTime

Enthält die maximale Zeit zum Scannen einer einzelnen Seite mit den aktuellen Eigenschafteneinstellungen in Millisekunden. Eine Anwendung liest diese Eigenschaft, um die Zeit zu schätzen, die zum Scannen einer Seite dauern wird. Dies ist hilfreich, wenn Sie die Bedingungen eines Geräts ermitteln, das nicht mehr reagiert. Der Minidriver erstellt und verwaltet diese Eigenschaft. Diese Eigenschaft ist für alle Scanner erforderlich.

Typ: VT_I4, Access: Schreibschutz, Gültige Werte: WIA_PROP_NONE
WIA_DPS_MIN_HORIZONTAL_SHEET_FEED_SIZE
ScannerDeviceMinHorizontalSheetFeedSize

Hinweis:
Diese Eigenschaft wird mit Windows Vista und höher nicht unterstützt. Verwenden Sie WIA_IPS_MIN_HORIZONTAL_SIZE.

 

Enthält die physischen horizontalen Abmessungen der kleinsten Seite, die der Dokumenteneinzug des Scanners scannen kann, in Tausendstel Zoll. Der Minidriver erstellt und verwaltet diese Eigenschaft.

Typ: VT_I4, Access: Schreibschutz, Gültige Werte: WIA_PROP_NONE

Siehe auch

WIA_DPS_MIN_VERTICAL_SHEET_FEED_SIZE
WIA_DPS_MIN_VERTICAL_SHEET_FEED_SIZE
ScannerDeviceMinVerticalSheetFeedSize

Hinweis:
Diese Eigenschaft wird mit Windows Vista und höher nicht unterstützt. Verwenden Sie WIA_IPS_MIN_VERTICAL_SIZE.

 

Enthält die physischen vertikalen Abmessungen der kleinsten Seite, die der Dokumenteinzug des Scanners scannen kann, in Tausendstel Zoll. Der Minidriver erstellt und verwaltet diese Eigenschaft.

Typ: VT_I4, Access: Schreibschutz, Gültige Werte: WIA_PROP_NONE

Siehe auch

WIA_DPS_MIN_HORIZONTAL_SHEET_FEED_SIZE
WIA_DPS_OPTICAL_XRES
ScannerDeviceOpticalXres

Hinweis:
Diese Eigenschaft wird von Windows Vista nicht unterstützt. Verwenden Sie WIA_IPS_OPTICAL_XRES.

 

Horizontale optische Auflösung. Höchste unterstützte horizontale optische Auflösung in DPI. Diese Eigenschaft ist ein einzelner Wert. Dies ist keine Liste aller Auflösungen, die vom Gerät generiert werden können. Dies ist vielmehr die Auflösung der Optik des Geräts. Der Minidriver erstellt und verwaltet diese Eigenschaft. Diese Eigenschaft ist für alle Scanner erforderlich.

Typ: VT_I4, Access: Schreibschutz, Gültige Werte: WIA_PROP_NONE
WIA_DPS_OPTICAL_YRES
ScannerDeviceOpticalYres

Hinweis:
Diese Eigenschaft wird von Windows Vista nicht unterstützt. Verwenden Sie WIA_IPS_OPTICAL_YRES.

 

Vertikale optische Auflösung. Höchste unterstützte vertikale optische Auflösung in DPI. Diese Eigenschaft ist ein einzelner Wert. Dies ist keine Liste aller Auflösungen, die vom Gerät generiert werden. Dies ist vielmehr die Auflösung der Optik des Geräts. Der Minidriver erstellt und verwaltet diese Eigenschaft. Diese Eigenschaft ist für alle Scanner erforderlich.

Typ: VT_I4, Access: Schreibschutz, Gültige Werte: WIA_PROP_NONE
WIA_DPS_ORIENTATION
ScannerDeviceOrientation

Enthält die aktuelle Ausrichtungseinstellung. Der Minidriver erstellt und verwaltet diese Eigenschaft.

Eine Anwendung legt die WIA_DPS_ORIENTATION-Eigenschaft fest, um die ursprüngliche Ausrichtung einer zu erwerbenden Seite oder eines Bilds zu definieren. Informationen zur Verwendung von WIA_DPS_ORIENTATION finden Sie unter WIA_DPS_PAGE_SIZE

Typ: VT_I4, Access: Lese-/Schreibzugriff, Gültige Werte: WIA_PROP_LIST

Die folgende Tabelle enthält die vier Konstanten, die mit dieser Eigenschaft gültig sind.

Wert Defination
QUERFORMAT 90-Grad-Drehung gegen den Uhrzeigersinn relativ zur PORTRAIT-Ausrichtung.
PORTRÄT 0 Grad.
ROT180 180-Grad-Drehung gegen den Uhrzeigersinn relativ zur PORTRAIT-Ausrichtung.
ROT270 270-Grad-Drehung gegen den Uhrzeigersinn relativ zur PORTRAIT-Ausrichtung.

 

Siehe auch

WIA_IPS_ROTATION
WIA_DPS_PAD_COLOR
ScannerDevicePadColor

Farbe, die zum Paden verwendet wird, wenn nicht genügend Bilddaten vorhanden sind, um einen angeforderten Puffer zu füllen. Diese Eigenschaft wird für Scanner implementiert, die den Puffer auffüllen. Diese Eigenschaft ist für alle Scanner optional. Der Minidriver erstellt und verwaltet diese Eigenschaft.

Typ: VT_UI1 | VT_VECTOR, Access: Schreibschutz, Gültige Werte: WIA_PROP_NONE

Das Format der Farbinformationen ist RGBQUAD.
WIA_DPS_PAGE_HEIGHT
ScannerDevicePageHeight

Hinweis:
Diese Eigenschaft wird von Windows Vista nicht unterstützt. Verwenden Sie WIA_IPS_PAGE_HEIGHT.

 

Enthält die Höhe der aktuell ausgewählten Seite in Tausendstel Zoll. Der Minidriver erstellt und verwaltet die eigenschaft WIA_DPS_PAGE_HEIGHT . Eine Anwendung liest diese Eigenschaft, um die physischen Dimensionen der zu scannenden Seite zu bestimmen. Wenn sich die Ausdehnungseinstellungen von den bekannten Seitengrößen unterscheiden, gibt diese Eigenschaft die Höhe der Seite an, deren WIA_DPS_PAGE_SIZE-Eigenschaft auf WIA_PAGE_CUSTOM festgelegt ist (ein Wert der WIA_DPS_PAGE_SIZE-Eigenschaft ). WIA_DPS_PAGE_HEIGHT muss mit WIA_IPS_XEXTENT synchronisiert sein, der die Höhe der zu scannenden Seite in Pixel meldet.

Typ: VT_I4, Access: Schreibschutz, Gültige Werte: WIA_PROP_NONE
WIA_DPS_PAGE_SIZE
ScannerDevicePageSize

Hinweis:
Diese Eigenschaft wird von Windows Vista nicht unterstützt. Verwenden Sie WIA_IPS_PAGE_SIZE.

 

Enthält die Größe der Seite, die derzeit für die Überprüfung ausgewählt ist. Um die Dimensionen der zu überprüfenden Seite auszuwählen, legt eine Anwendung diese Eigenschaft fest. Der Minidriver erstellt und verwaltet diese Eigenschaft.

Typ: VT_I4, Access: Lese-/Schreibzugriff, Gültige Werte: WIA_PROP_LIST

Die folgende Tabelle enthält die drei Konstanten, die mit dieser Eigenschaft gültig sind.

Wert Definition
WIA_PAGE_A4 8267 X 11692 (HOCHFORMAT)
WIA_PAGE_CUSTOM Definiert durch die Werte der Eigenschaften WIA_DPS_PAGE_HEIGHT und WIA_DPS_PAGE_WIDTH
WIA_PAGE_LETTER 8500 x 11000 (HOCHFORMAT)

 

Der Wert der WIA_IPS_ORIENTATION-Eigenschaft bestimmt die Ausrichtung der aktuell ausgewählten Seite. Die Eigenschaften WIA_DPS_PAGE_WIDTH und WIA_DPS_PAGE_HEIGHT geben die Seitenabmessungen in Tausendstel Zoll an. Beachten Sie, dass diese Eigenschaften mit WIA_IPS_XEXTENT und WIA_IPS_YEXTENT übereinstimmen müssen, die die Seitenabmessungen in Pixel enthalten. Gültige Werte vom Typ WIA_PROP_LIST sollten von gültigen Einstellungen der WIA_IPS_ORIENTATION-Eigenschaft abhängen. Wenn das Gerät keine querformatorientierten Dokumente mit einer WIA_PAGE_A4-Einstellung scannen kann, sollte WIA_PAGE_A4 nicht in der Liste der gültigen Werte für die eigenschaft WIA_DPS_PAGE_SIZE angezeigt werden, wenn WIA_IPS_ORIENTATION auf LANSCAPE festgelegt ist.

Wenn eine Anwendung WIA_DPS_PAGE_SIZE auf einen anderen Wert als WIA_PAGE_CUSTOM festlegt, sollte der Minitreiber die Werte von WIA_DPS_PAGE_WIDTH und WIA_DPS_PAGE_HEIGHT an die Seitenabmessungen in Tausendstel Zoll anpassen. Außerdem sollten die Werte von WIA_IPS_XEXTENT und WIA_IPS_YEXTENT an die Seitenabmessungen in Pixel angepasst werden.

Wenn eine Erweiterungseinstellung (WIA_IPS_XEXTENT oder WIA_IPS_YEXTENT) in einen Wert geändert wird, der nicht mit der aktuellen Einstellung für die Seitengröße übereinstimmt, sollte der Minitreiber den Wert der WIA_DPS_PAGE_SIZE-Eigenschaft in WIA_PAGE_CUSTOM ändern. Der Minidriver sollte auch WIA_DPS_PAGE_WIDTH oder WIA_DPS_PAGE_HEIGHT entsprechend der neuen Erweiterungseinstellung ändern.

Wenn WIA_IPS_ORIENTATION auf LANSCAPE festgelegt ist, werden die Erweiterungseinstellungen "umgedreht". Wenn eine Anwendung beispielsweise WIA_DPS_PAGE_SIZE auf WIA_PAGE_A4 festlegt, sollte der Minitreiber WIA_DPS_PAGE_WIDTH auf 11692 und WIA_DPS_PAGE_HEIGHT auf 8267 festlegen. (Der Minitreiber sollte auch WIA_IPS_XEXTENT festlegen und entsprechend WIA_IPS_YEXTENT .) Beachten Sie, dass , wenn WIA_DPS_PAGE_SIZE auf WIA_PAGE_CUSTOM festgelegt ist, die Ausrichtungseinstellung nicht verwendet wird, um die Ausmaße der zu scannenden Seite zu bestimmen.

Der Minidriver ist dafür verantwortlich, sicherzustellen, dass die WIA_IPS_ORIENTATION Eigenschaft mit dem aktuellen Auswahlbereich übereinstimmen. Wenn eine Anwendung den Wert von WIA_IPS_ORIENTATION in einen wert ändert, der für die aktuell ausgewählte Seitengröße ungültig ist, sollte der Minitreiber den Wert von WIA_DPS_PAGE_SIZE in eine Seitengröße ändern, die vom neuen Ausrichtungswert unterstützt wird.

Wenn eine Anwendung die WIA_DPS_PAGE_SIZE-Eigenschaft auf WIA_PAGE_CUSTOM festlegt, ist der aktuelle Auswahlbereich nicht betroffen. Der WIA-Minitreiber sollte das aktuelle Bildlayout abrufen, beginnend mit den aktuellen Einstellungen der eigenschaften WIA_IPS_XPOS und WIA_IPS_YPOS . Wenn die Einstellung für die Seitengröße zu einem Auswahlbereich führt, der sich außerhalb des Scannerbetts befindet, muss der Minidriver die Werte der WIA_IPS_XPOS und WIA_IPS_YPOS Eigenschaften automatisch an gültige Einstellungen anpassen. Wenn die Eigenschaften WIA_DPS_PAGE_SIZE und WIA_IPS_ORIENTATION gleichzeitig festgelegt sind und ungültig sind, wenn sie in Kombination angewendet werden, sollte der Minitreiber die Einstellungen der Anwendung fehlschlagen, indem ein Fehler in IWiaMiniDrv::d rvValidateItemProperties zurückgegeben wird. .

Die folgenden vier Beispiele zeigen verschiedene WIA_DPS_PAGE_SIZE Szenarien.

  1. Der Treiber meldet die Einstellungen.
  2. Eine Anwendung legt die WIA_DPS_PAGE_SIZE-Eigenschaft auf WIA_PAGE_LETTER fest.
  3. Eine Anwendung legt die WIA_IPS_ORIENTATION-Eigenschaft auf LANSCAPE fest.
  4. Eine Anwendung ändert die WIA_IPS_XEXTENT-Eigenschaft in einen kleineren Wert.

Beispiel 1: Der Minitreiber meldet die Einstellungen.

Im folgenden Beispiel legt der Minidriver einen benutzerdefinierten Auswahlbereich fest, bevor eine Anwendung WIA-Eigenschaften festlegt. In diesem Fall stellt der Auswahlbereich das gesamte Flachbett dar.

WIA_DPS_PAGE_SIZE = WIA_PAGE_CUSTOM
WIA_DPS_PAGE_WIDTH = 11500
WIA_DPS_PAGE_HEIGHT = 14000
WIA_IPS_ORIENTATION = PORTRAIT
WIA_IPS_XPOS = 0
WIA_IPS_YPOS = 0
WIA_IPS_XEXTENT = 1150
WIA_IPS_YEXTENT = 1400
WIA_IPS_XRES = 100
WIA_IPS_YRES = 100

Beispiel 2: Eine Anwendung legt dieeigenschaft WIA_DPS_PAGE_SIZEauf WIA_PAGE_LETTER

WIA_DPS_PAGE_SIZE = WIA_PAGE_LETTER
WIA_DPS_PAGE_WIDTH = 8500
WIA_DPS_PAGE_HEIGHT = 11000
WIA_IPS_ORIENTATION = PORTRAIT
WIA_IPS_XPOS = 0
WIA_IPS_YPOS = 0
WIA_IPS_XEXTENT = 850
WIA_IPS_YEXTENT = 1100
WIA_IPS_XRES = 100
WIA_IPS_YRES = 100

Beispiel 3: Eine Anwendung legt dieeigenschaft WIA_IPS_ORIENTATIONauf LANSCAPE fest.

Das physische Bett muss in der Lage sein, eine Seite zu erhalten, die sich ursprünglich im Querformat befand.

WIA_DPS_PAGE_SIZE = WIA_PAGE_LETTER
WIA_DPS_PAGE_HEIGHT = 11000
WIA_DPS_PAGE_WIDTH = 8500
WIA_IPS_ORIENTATION = LANSCAPE
WIA_IPS_XPOS = 0
WIA_IPS_YPOS = 0
WIA_IPS_XEXTENT = 1100
WIA_IPS_YEXTENT = 850
WIA_IPS_XRES = 100
WIA_IPS_YRES = 100

Beispiel 4: Eine Anwendung ändert dieeigenschaft WIA_IPS_XEXTENTin einen kleineren Wert.

Im folgenden Beispiel ändert eine Anwendung die eigenschaft WIA_IPS_XEXTENT in 1000. Der Minidriver sollte davon ausgehen, dass der in WIA_IPS_XEXTENT enthaltene neue Wert für die eigenschaft WIA_DPS_PAGE_SIZE nicht mehr gültig ist und daher WIA_DPS_PAGE_SIZE in WIA_PAGE_CUSTOM ändern sollte. Der Minitreiber muss auch WIA_DPS_PAGE_WIDTH anpassen.

WIA_DPS_PAGE_SIZE = WIA_PAGE_CUSTOM
WIA_DPS_PAGE_HEIGHT = 10000
WIA_DPS_PAGE_WIDTH = 8500
WIA_IPS_ORIENTATION = LANSCAPE
WIA_IPS_XPOS = 0
WIA_IPS_YPOS = 0
WIA_IPS_XEXTENT = 1000
WIA_IPS_YEXTENT = 850
WIA_IPS_XRES = 100
WIA_IPS_YRES = 100
WIA_DPS_PAGE_WIDTH
ScannerDevicePageWidth

Hinweis:
Diese Eigenschaft wird von Windows Vista nicht unterstützt. Verwenden Sie WIA_IPS_PAGE_WIDTH.

 

Enthält die Breite der ausgewählten aktuellen Seite in Tausendstel zoll. Eine Anwendung liest diese Eigenschaft, um die physischen Dimensionen der zu scannenden Seite zu bestimmen. Wenn sich die Erweiterungseinstellungen von bekannten Seitengrößen unterscheiden, gibt diese Eigenschaft die Breite der Seite an, deren WIA_DPS_PAGE_SIZE-Eigenschaft auf WIA_PAGE_CUSTOM festgelegt ist. WIA_DPS_PAGE_WIDTH muss mit dem Wert von WIA_IPS_XEXTENT synchronisiert sein, der die Breite der zu scannenden Seite in Pixel angibt. Der Minidriver erstellt und verwaltet diese Eigenschaft.

Typ: VT_I4, Access: Schreibschutz, Gültige Werte: WIA_PROP_NONE
WIA_DPS_PAGES
ScannerDevicePages

Hinweis:
Diese Eigenschaft wird von Windows Vista nicht unterstützt. Verwenden Sie WIA_IPS_PAGES.

 

Enthält die aktuelle Anzahl von Seiten, die aus einem automatischen Dokumentzuführung abgerufen werden sollen. Der Minidriver erstellt und verwaltet diese Eigenschaft.

Typ: VT_I4; Zugriff: Lese-/Schreibzugriff; Gültige Werte: WIA_PROP_RANGE (null bis zur maximalen Anzahl von Seiten, die der Dokumentfeed enthalten kann)

Eine Anwendung liest diese Eigenschaft, um die Seitenkapazität des Dokumentzuführungsvorgangs zu bestimmen. Die Anwendung legt diese Eigenschaft auch auf die Anzahl der Zu überprüfenden Seiten fest.

Hinweis:
Wenn der Duplexmodus aktiviert ist (WIA_DPS_DOCUMENT_HANDLING_SELECT auf FEEDER | DUPLEX ), WIA_DPS_PAGES ist immer noch gleich der Anzahl der zu scannenden Seiten.

 

Ein Blatt Papier enthält automatisch zwei Seiten, wenn DUPLEX aktiviert ist, auch wenn die Rückseite der Seite leer ist.

Wenn Sie WIA_DPS_PAGES auf 1 festlegen, verarbeitet ein Scanner eine der Seiten der Seite. Wenn ein Scanner im Duplexmodus nicht nur eine Seite einer Seite scannen kann, sollte der WIA_DPS_PAGES gültigen Wert für das Inc-Element der WIA_PROPERTY_INFO-Struktur in 2 geändert werden. Dieser Wert signalisiert der Anwendung, dass sie Seiten in Vielfachen von zwei anfordern muss. Der Wert 0 (null) bedeutet, dass alle Seiten, die derzeit in den Dokumenteinzug geladen werden, gescannt werden sollen.
WIA_DPS_PLATEN_COLOR
ScannerDevicePlatenColor

Gibt die Farbe der Platte hinter dem zu scannenden Blatt an. Diese Eigenschaft ist optional für Scanner, die über eine Platte verfügen. Der Minidriver erstellt und verwaltet diese Eigenschaft.

Typ: VT_UI1 | VT_VECTOR, Zugriff: Schreibgeschützt, Gültige Werte: WIA_PROP_NONE

Das Format der Farbinformationen ist RGBQUAD.
WIA_DPS_PREVIEW
ScannerDevicePreview

Hinweis:
Diese Eigenschaft wird von Windows Vista nicht unterstützt. Verwenden Sie WIA_IPS_PREVIEW.

 

Gibt den Vorschaumodus für ein Gerät an. Eine Anwendung legt diese Eigenschaft so fest, dass das Gerät in einen Vorschaumodus versetzt wird.

Typ: VT_I4, Zugriff: Lese-/Schreibzugriff, Gültige Werte: WIA_PROP_LIST

Die folgende Tabelle enthält die beiden Konstanten, die für diese Eigenschaft gültig sind.

Wert Definition
WIA_FINAL_SCAN Die Anwendung führt eine abschließende Überprüfung durch.
WIA_PREVIEW_SCAN Die Anwendung führt eine Vorschauüberprüfung durch.

 
WIA_DPS_SCAN_AHEAD_PAGES
ScannerDeviceScanAheadPages

Enthält einen Wert, der angibt, ob der Scanner Seiten in einem Scannerpuffer zwischenspeichert, bevor er sie an die Anwendung sendet.

Mit dem Wert null wird die Überprüfung im Voraus deaktiviert, und es werden keine Seiten im Voraus gescannt. Durch normale Datenübertragungen für das gepufferte Scan-Ahead-Element werden die gepufferten Seiten abgerufen. WIA-Eigenschaften können während eines Scan-Ahead-Vorgangs nicht geändert werden. Diese Eigenschaft ist optional.

Typ: VT_I4, Access: Lese-/Schreibzugriff, Gültige Werte: WIA_PROP_RANGE von 0 auf die maximale Anzahl von Seiten, die der Dokumentzubringer enthalten kann.
WIA_DPS_SCAN_AVAILABLE_ITEM
ScannerDeviceScanAvailableItem

Hinweis:
Diese Eigenschaft wird nur von Windows 7 und höher unterstützt.

 

Gibt die Eingabequelle (Flatbed, automatische Dokumentzuführung oder Fil-Scanning-Adapter) an, von der aus gescannt werden soll, oder den Speicherort, von dem Daten übertragen werden sollen.

Ein Scanereignis benachrichtigt die Anwendung, dass der Benutzer eine Überprüfung initiiert hat, aber das Ereignis gibt nicht den Namen des WIA-Elements an, das die Eingabequelle darstellt. Der Ereignishandler der Anwendung kann die WIA_DPS_SCAN_AVAILABLE_ITEM Eigenschaft des Stammelements abfragen, um den Namen des Eingabequellelements abzurufen.

Typ: VT_I4, Access: Lese-/Schreibzugriff, Gültige Werte: WIA_PROP_RANGE von 0 auf die maximale Anzahl von Seiten, die der Dokumentzubringer enthalten kann.
WIA_DPS_SERVICE_ID
ScannerDeviceServiceId

Hinweis:
Diese Eigenschaft wird nur von Windows Vista und höher unterstützt.

 

Enthält die Dienst-ID eines Webdienst-Scannergeräts. Der WIA 2.0-Minitreiber erstellt und verwaltet diese Eigenschaft.

Typ: VT_BSTR, Zugriff: Schreibgeschützt, Gültige Werte: WIA_PROP_NONE
WIA_DPS_SHEET_FEEDER_REGISTRATION
ScannerDeviceSheetFeederRegistration

Hinweis:
Diese Eigenschaft wird mit Windows Vista und höher nicht unterstützt. Verwenden Sie WIA_IPS_SHEET_FEEDER_REGISTRATION.

 

Enthält die Registrierung oder Ausrichtung und Kantenerkennung für Dokumente, die auf dem Flachbett platziert werden. Der Minidriver erstellt und verwaltet diese Eigenschaft. Diese Eigenschaft gibt an, wie das Blatt horizontal auf dem Scankopf eines Hand- oder Blattscanners positioniert ist. Die -Eigenschaft wird verwendet, um vorherzusagen, wo sich ein Dokument über dem Scankopf befindet.

Bei Scannern, die mehr als einen Scankopf unterstützen, ist diese Eigenschaft relativ zum obersten Scankopf. Diese Eigenschaft ist für Scanner mit Blatt-, Bildlauf- und Handscannern obligatorisch.

Typ: VT_I4, Zugriff: Schreibgeschützt, Gültige Werte: WIA_PROP_NONE

Die folgende Tabelle enthält die drei Konstanten, die für diese Eigenschaft gültig sind.

Dauerhaft BESCHREIBUNG
LEFT_JUSTIFIED Das Blatt wird in Bezug auf den Scankopf links positioniert.
ZENTRIERT Das Blatt ist auf dem Scankopf zentriert.
RIGHT_JUSTIFIED Das Blatt wird in Bezug auf den Scankopf rechts positioniert.

 
WIA_DPS_SHOW_PREVIEW_CONTROL
ScannerDeviceShowPreviewControl

Hinweis:
Diese Eigenschaft wird von Windows Vista nicht unterstützt. Verwenden Sie WIA_IPS_SHOW_PREVIEW_CONTROL.

 

Gibt an, ob ein Element ein Vorschausteuerelement benötigt, das dem Benutzer angezeigt wird. Der Minidriver erstellt und verwaltet diese Eigenschaft.

Typ: VT_I4, Zugriff: Schreibgeschützt, Gültige Werte: WIA_PROP_NONE

Die folgende Tabelle enthält die beiden Konstanten, die für diese Eigenschaft gültig sind.

Dauerhaft BESCHREIBUNG
WIA_SHOW_PREVIEW_CONTROL Zeigen Sie dem Benutzer ein Vorschausteuerelement an, da dieses Gerät eine Vorschau ausführen kann.
WIA_DONT_SHOW_PREVIEW_CONTROL Zeigen Sie dem Benutzer kein Vorschausteuerelement an, da dieses Gerät keine Vorschau ausführen kann.

 
WIA_DPS_USER_NAME
ScannerDeviceUserName

Hinweis:
Diese Eigenschaft wird nur von Windows Vista und höher unterstützt.

 

Wird vom WIA-Dienst verwendet, um den Minitreiber über den Benutzerkontonamen (einschließlich des Netzwerkdomänennamens, falls zutreffend) der Sitzung zu informieren, in der die aktuelle WIA-Anwendung ausgeführt wird.

Dies ist eine Stammelementeigenschaft, die vom WIA-Dienst verwaltet wird.

Typ: VT_BSTR, Zugriff: Schreibgeschützt, Gültige Werte: WIA_PROP_NONE
WIA_DPS_VERTICAL_BED_REGISTRATION
ScannerDeviceVerticalBedRegistration

Hinweis:
Diese Eigenschaft wird mit Windows Vista und höher nicht unterstützt.

 

Enthält die Registrierung oder vertikale Ausrichtung und Kantenerkennung für Dokumente, die auf dem Flachbett platziert werden. Der Minidriver erstellt und verwaltet diese Eigenschaft.

Typ: VT_I4, Zugriff: Schreibgeschützt, Gültige Werte: WIA_PROP_NONE

Die folgende Tabelle enthält die drei Konstanten, die mit dieser Eigenschaft gültig sind.

Dauerhaft BESCHREIBUNG
TOP_JUSTIFIED Das Papier ist am besten gerechtfertigt.
ZENTRIERT Das Papier ist zentriert.
BOTTOM_JUSTIFIED Das Papier ist unten gerechtfertigt.

 

Siehe auch.

WIA_DPS_HORIZONTAL_BED_REGISTRATION
WIA_DPS_VERTICAL_BED_SIZE
ScannerDeviceVerticalBedSize

Hinweis:
Diese Eigenschaft wird mit Windows Vista und höher nicht unterstützt. Verwenden Sie WIA_IPS_MAX_VERTICAL_SIZE.

 

Gibt die maximale Höhe in Tausendstel Zoll an, die in der vertikalen Achse (Y) von der Platte eines Flachbettscanners mit der aktuellen Auflösung gescannt wird. Diese Eigenschaft gilt auch für automatische Dokumentzuführungen, die Blätter zum Scannen auf die Platte eines Flachbettscanners verschieben. Diese Eigenschaft ist für Scanner erforderlich, die über eine Platte verfügen. Andere Scannertypen implementieren stattdessen die eigenschaft WIA_DPS_VERTICAL_SHEET_FEED_SIZE .

Typ: VT_I4, Zugriff: Schreibgeschützt, Gültige Werte: WIA_PROP_NONE
WIA_DPS_VERTICAL_SHEET_FEED_SIZE
ScannerDeviceVerticalSheetFeedSize

Hinweis:
Diese Eigenschaft wird mit Windows Vista und höher nicht unterstützt. Verwenden Sie WIA_IPS_MAX_VERTICAL_SIZE.

 

Gibt die maximale Höhe in tausendstel Zoll an, die in der vertikalen Achse (Y) von einem Handheld- oder Blattvorschubscanner mit der aktuellen Auflösung gescannt wird. Diese Eigenschaft gilt auch für automatische Dokumentzuführungen, die scannen, ohne Blätter auf die Platte eines Flachbettscanners zu verschieben. Diese Eigenschaft ist für Scanner mit Blattgefüttert obligatorisch. Bildlauf- und Handscanner sollten diese Eigenschaft nicht implementieren.

Typ: VT_I4, Zugriff: Schreibgeschützt, Gültige Werte: WIA_PROP_NONE

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client)
 Windows 2000 Professional, Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server)
 Windows Server 2003 [nur Desktop-Apps]
Header
Wiadef.h