Allgemeine WIA-Elementeigenschaftenkonstanten

Die folgenden Geräteeigenschaftenkonstanten müssen von allen IWiaItem-, IWiaItem2- und IWiaDrvItem-Schnittstellenschnittstellen unterstützt werden, sofern in ihren Beschreibungen nichts anderes angegeben ist.

Das Präfix "WIA_IPA_" gibt eine Elementeigenschaft für alle Geräte an und ist die in C/C++ verwendete Namenskonvention. Zu Skriptzwecken verwenden diese Konstanten das Präfix "Picture" 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_IPA_ACCESS_RIGHTS
PictureAccessRights
Dieses Flag steuert den Zugriff auf das Element sowie, ob das Element gelöscht wird.
Erforderlich für alle WIA 2.0-Elemente.
Typ: VT_I4; Lese-/Schreibzugriff oder Schreibschutz, je nachdem, ob die Zugriffsrechte des Elements geändert werden können; Gültige Werte: WIA_PROP_FLAG
Die folgende Tabelle enthält die fünf Flags, die für diese Eigenschaft gültig sind.
Zugriffsrecht BESCHREIBUNG
WIA_ITEM_READ Das Element verfügt über schreibgeschützten Zugriff.
WIA_ITEM_WRITE Das Element verfügt über schreibgeschützten Zugriff.
WIA_ITEM_CAN_BE_DELETED Das Element verfügt nur über Löschzugriff.
WIA_ITEM_RD WIA_ITEM_READ | WIA_ITEM_CAN_BE_DELETED
WIA_ITEM_RWD WIA_ITEM_READ | WIA_ITEM_WRITE | WIA_ITEM_CAN_BE_DELETED

 

WIA_IPA_APP_COLOR_MAPPING
PictureAppColorMapping

Diese Eigenschaft ist für die zukünftige Verwendung reserviert und wird derzeit nicht implementiert.

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

WIA_IPA_BITS_PER_CHANNEL
PictureBitsPerChannel

Enthält die Anzahl der Bits pro Kanal für das Bild. Der Minidriver erstellt und verwaltet diese Eigenschaft.

Erforderlich für alle WIA 2.0-fähigen oder gespeicherten Bildelemente.

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

WIA_IPA_BUFFER_SIZE
PictureBufferSize

Enthält die Größe des Puffers in Bytes, der während einer Datenübertragung verwendet wird. Der Minidriver erstellt und verwaltet diese Eigenschaft.

Eine Anwendung kann diese Eigenschaft lesen, um die vom Treiber angegebene Puffergröße für Datenübertragungen zu bestimmen. Der WIA-Dienst liest diese Eigenschaft auch, um während der Datenübertragung Arbeitsspeicher für den Minitreiber zuzuweisen.

Optional für alle übertragungsfähigen WIA 2.0-Elemente.

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

Hinweis:
Die WIA_IPA_BUFFER_SIZE -Eigenschaft enthält die Mindestmenge an Daten, die eine Anwendung zu einem bestimmten Zeitpunkt anfordern kann. Je größer die Puffergröße, desto größer sind die Anforderungen an das Gerät. Dies kann dazu führen, dass das Gerät langsam und nicht reagiert, die Gesamtleistung des Systems verlangsamt und übermäßige Ressourcen verbraucht. Zu kleine Puffergrößen können die Leistung der Datenübertragung verlangsamen, da viele kleinere Anforderungen erforderlich sind. Wählen Sie eine angemessene Puffergröße aus, indem Sie die typische Größe einer Datenanforderung an Ihr Gerät berücksichtigen und die Anzahl der Anforderungen mit der Größe dieser Anforderungen ausgleichen.

 
WIA_IPA_BYTES_PER_LINE
PictureBytesPerLine

Enthält die Anzahl von Bytes in einer Scanzeile des Bilds. Der Minidriver erstellt und verwaltet diese Eigenschaft.

Optional für alle WIA 2.0-Elemente.

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

WIA_IPA_CHANNELS_PER_PIXEL
PictureChannelsPerPixel

Enthält die Anzahl der Kanäle pro Pixel für das Bild. Der Minidriver erstellt und verwaltet diese Eigenschaft.

Erforderlich für alle WIA 2.0-fähigen oder gespeicherten Bildelemente.

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

WIA_IPA_COLOR_PROFILE
PictureColorProfile

Diese Eigenschaft ist für die zukünftige Verwendung reserviert und wird derzeit nicht implementiert.

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

WIA_IPA_COMPRESSION
PictureCompression

Enthält den aktuellen verwendeten Komprimierungstyp. Der Minidriver erstellt und verwaltet diese Eigenschaft.

Eine Anwendung liest diese Eigenschaft, um den Bildkomprimierungstyp zu bestimmen, oder legt diese Eigenschaft fest, um die Komprimierungseinstellung zu konfigurieren.

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

Die folgende Tabelle enthält die Konstanten, die für diese Eigenschaft gültig sind. Das V-Symbol gibt an, dass die Konstante nur in Windows Vista und höher unterstützt wird. (Es ist nur über die IWiaItem2-Schnittstelle verfügbar.)

Komprimierungstyp BESCHREIBUNG
WIA_COMPRESSION_NONE Keine Komprimierung. Weitere Informationen finden Sie unter Hinweis .
WIA_COMPRESSION_AUTO Automatischer Komprimierungsmodus. Weitere Informationen finden Sie unter Hinweis .
WIA_COMPRESSION_BI_RLE4 RLE4-Komprimierung
WIA_COMPRESSION_BI_RLE8 RLE8-Komprimierung
WIA_COMPRESSION_G3 Gruppe 3-Komprimierung
WIA_COMPRESSION_G4 Gruppe 4-Komprimierung
WIA_COMPRESSION_JPEG JPEG-Komprimierung.
WIA_COMPRESSION_JBIGV JBIG-Komprimierung.
WIA_COMPRESSION_JPEG2KV JPEG 2000-Komprimierung.
WIA_COMPRESSION_PNGV PNG-Komprimierung.

 

[!Hinweis]

Wenn diese Eigenschaft WIA_COMPRESSION_NONE ist und WIA_IPA_FORMAT entweder WiaImgFmt_PDFA oder WiaImgFmt_XPS ist; dann bedeutet WIA_COMPRESSION_NONE, dass der Komprimierungsmodus nicht definiert ist und der Scanner sich für einen Modus entscheiden muss.

WIA_COMPRESSION_AUTO ist ein neuer Eigenschaftswert, der für die eigenschaft WIA_IPA_COMPRESSION definiert ist. Dieser Wert gilt für alle programmierbaren Bilddatenquellenelemente, einschließlich Flatbed und Feeder. Wenn dieser Wert vom WIA-Minitreiber unterstützt wird, kann der WIA-Anwendungsclient WIA_IPA_COMPRESSION festlegen, um die automatische Komprimierungsmoduserkennung auf dem Gerät zu aktivieren. WIA_COMPRESSION_AUTO können mit und arbeiten, ohne dass die vollständige automatische Farbe unterstützt oder aktiviert wird (WIA_DATA_AUTO und WIA_DEPTH_AUTO).

WIA_COMPRESSION_AUTO ist besonders nützlich bei Übertragungsdateiformaten, die mehrere Datentypen und Bittiefen unterstützen, z. B. WiaImgFmt_RAW. Weitere Informationen zu Übertragungsdateiformaten finden Sie unter WIA_IPA_FORMAT in dieser Tabelle.

Es ist für den WIA Mini-Fahrer geeignet, WIA_COMPRESSION_AUTO. Wenn er unterstützt wird, darf der WIA-Minitreiber ihn niemals als Standardwert für WIA_IPA_COMPRESSION festlegen. nur die WIA-Anwendung kann diesen Wert festlegen.

 
WIA_IPA_DATATYPE
PictureDatatype

Enthält die aktuelle Datentypeinstellung für das Gerät. Der Minidriver erstellt und verwaltet diese Eigenschaft.

Eine Anwendung liest diese Eigenschaft, um den Datentyp des Bilds zu bestimmen. Eine Anwendung schreibt diese Eigenschaft, um den aktuellen Datentyp des Zu übertragenden Bilds festzulegen.

Diese Eigenschaft ist für alle WIA 2.0-Elemente erforderlich. Es muss lese-/schreibzugriff für alle WIA 2.0-Erfassungselemente und Schreibschutz für WIA 2.0-Speicherelemente sein.

Typ: VT_I4; Zugriff für Betriebssysteme vor Windows Vista: Diese Eigenschaft ist schreibgeschützt für Kameras und Lese-/Schreibzugriff für Scanner. Zugriff für Windows Vista und höher: Diese Eigenschaft ist schreibgeschützter Wert für WIA_CATEGORY_FOLDER- und WIA_CATEGORY_FINISHED_FILE-Elemente und Lese-/Schreibzugriff für alle anderen WIA 2.0-Elementkategorien. Gültige Werte: WIA_PROP_LIST

Die folgende Tabelle enthält die sechs Konstanten, die mit gültig sind, wenn WIA_IPA_FORMAT nicht auf WiaImgFmt_RAW festgelegt ist.

Datentyp BESCHREIBUNG
WIA_DATA_AUTO Gültig für alle programmierbaren Bilddatenquellenelemente, einschließlich Flatbed und Feeder. Wenn dieser Wert vom WIA-Minitreiber unterstützt wird, kann der WIA-Anwendungsclient WIA_IPA_DATATYPE festlegen, um die automatische Farberkennung auf dem Gerät zu aktivieren. Wenn WIA_DATA_AUTO festgelegt ist, muss der WIA-Minitreiber WIA_IPA_DEPTH für dasselbe Element auf WIA_DEPTH_AUTO aktualisieren (dies muss ein unterstützter Wert sein, wenn das Gerät automatische Farben unterstützt).
Dies ist ein optionaler Wert, der jedoch erforderlich ist, wenn WIA_DEPTH_AUTO für WIA_IPA_DEPTH unterstützt wird.
WIA_DATA_COLOR Scandaten sind rot, grün, blau (RGB). Das vollständige Farbformat wird mithilfe der folgenden WIA-Eigenschaften beschrieben: WIA_IPA_CHANNELS_PER_PIXEL
WIA_IPA_BITS_PER_CHANNEL
WIA_IPA_PLANAR
WIA_IPA_PIXELS_PER_LINE
WIA_IPA_BYTES_PER_LINE
WIA_IPA_NUMBER_OF_LINES
WIA_DATA_COLOR_DITHER Identisch mit WIA_DATA_COLOR, außer dass die Daten mithilfe des derzeit ausgewählten Dithermusters ditheriert werden.
WIA_DATA_COLOR_THRESHOLD Identisch mit WIA_DATA_COLOR mit der Ausnahme, dass der Schwellenwert beim Scannen der Daten verwendet wird. Farbwerte über dem WIA_IPS_THRESHOLD Wert werden in die volle Helligkeit konvertiert; Farben unter diesem Wert werden in Schwarz konvertiert.
WIA_DATA_DITHER Scandaten werden mithilfe des derzeit ausgewählten Dithermusters ditheriert.
WIA_DATA_GRAYSCALE Scandaten stellen die Intensität dar. Die Palette ist eine feste Grauskala mit gleichem Abstand, deren Tiefe durch WIA_IPA_DEPTH -Eigenschaft angegeben wird.
WIA_DATA_THRESHOLD Der Schwellenwert beträgt ein Bit pro Pixel schwarzweißer Daten. Daten über dem aktuellen Wert von WIA_IPS_THRESHOLD werden in Weiß konvertiert; Daten unter diesem Wert werden in Schwarz konvertiert.

 

Die eigenschaft WIA_IPA_DATATYPE wird auch verwendet, um den Typ der RAW-Datenübertragung zu beschreiben, die verwendet werden soll, wenn die Anwendung WiaImgFmt_RAW festlegt. Der Treiber sollte die WIA_IPA_DATATYPE-Eigenschaft auf eine Liste zulässiger Werte festlegen, aus denen die Anwendung einen auswählen kann.

Wenn das Gerät nur auf einen einzelnen Wert festgelegt werden kann, erstellen Sie einen WIA_PROP_LIST Typ, und platzieren Sie den gültigen Wert darin.

Überprüfen Sie die WIA_IPA_DEPTH-Eigenschaft , um die Bittiefe zu bestimmen. Diese Eigenschaft enthält in der Regel einen einzelnen Wert für Kameras.

In der folgenden Tabelle sind die Konstanten aufgeführt, die mit WIA_IPA_DATATYPE gültig sind, wenn WIA_IPA_FORMAT auf WiaImgFmt_RAW festgelegt ist.

Datentyp BESCHREIBUNG
WIA_DATA_GRAYSCALE Scandaten stellen die Intensität dar. Die Palette ist eine feste Grauskala mit gleichem Abstand mit einer durch die WIA_IPA_DEPTH-Eigenschaft angegebenen Tiefe. WIA_IPA_RAW_BITS_PER_CHANNEL muss auf 1 festgelegt werden.
WIA_DATA_RAW_BGR Scandaten werden im BGR-Farbraum (Blau-Grün-Rot) angezeigt. Das vollständige Farbformat wird mit den folgendenWIA-Eigenschaften beschrieben: WIA_IPA_CHANNELS_PER_PIXEL
WIA_IPA_BITS_PER_CHANNEL
WIA_IPA_PIXELS_PER_LINE
WIA_IPA_BYTES_PER_LINE
WIA_IPA_NUMBER_OF_LINES
WIA_IPA_RAW_BITS_PER_CHANNEL muss auf 3 festgelegt werden.
WIA_DATA_RAW_CMY Die Scandaten befinden sich im Cmy-Farbraum (Cyan-Magenta-Yellow). Das vollständige Farbformat wird mit den gleichen WIA-Eigenschaften wie in WIA_DATA_RAW_BGR beschrieben. WIA_IPA_RAW_BITS_PER_CHANNEL muss auf 3 festgelegt werden.
WIA_DATA_RAW_CMYK Scandaten befinden sich im Farbraum cyan-magenta-yellow-black (CMYK). Das vollständige Farbformat wird mit den gleichen WIA-Eigenschaften wie in WIA_DATA_RAW_BGR beschrieben. WIA_IPA_RAW_BITS_PER_CHANNEL muss auf 4 festgelegt werden.
WIA_DATA_RAW_RGB Scandaten werden im Farbraum Rot-Grün-Blau (RGB) angezeigt. Das vollständige Farbformat wird mit den gleichen WIA-Eigenschaften wie in WIA_DATA_RAW_BGR beschrieben. WIA_IPA_RAW_BITS_PER_CHANNEL muss auf 3 festgelegt werden.
WIA_DATA_RAW_YUV Die Scandaten werden im YuV-Farbraum (Luminance-Blue Difference-Red Difference, Differenz rot) angezeigt. Das vollständige Farbformat wird mit den gleichen WIA-Eigenschaften wie in WIA_DATA_RAW_BGR beschrieben. WIA_IPA_RAW_BITS_PER_CHANNEL muss auf 3 festgelegt werden.
WIA_DATA_RAW_YUVK Die Scandaten sind im YuVK-Farbraum (Luminance-Blue Difference-Red Difference-Black) enthalten. Das vollständige Farbformat wird mit den gleichen WIA-Eigenschaften wie in WIA_DATA_RAW_BGR beschrieben. WIA_IPA_RAW_BITS_PER_CHANNEL muss auf 4 festgelegt werden.

 

WIA_IPA_DEPTH
PictureDepth

WIA_IPA_DEPTH Enthält die Bittiefeeinstellung eines Bilds. Der Minidriver erstellt und verwaltet diese Eigenschaft. Eine Anwendung liest diese Eigenschaft, um die Einstellung für die Bittiefe des Bilds zu bestimmen. Möglicherweise kann die Anwendung diesen Wert auch auf die gewünschte Bittiefe festlegen.

Wenn das Gerät nur auf einen einzelnen Wert festgelegt werden kann, erstellen Sie einen WIA_PROP_LIST Typ, und platzieren Sie den gültigen Wert darin.

Diese Eigenschaft ist für alle WIA 2.0-Elemente erforderlich. Es muss lese-/schreibzugriff für alle WIA 2.0-Erfassungselemente und Schreibschutz für WIA 2.0-Speicherelemente sein.

Typ: VT_I4; Zugriff für Betriebssysteme vor Windows Vista: Lese-/Schreibzugriff; Zugriff für Windows Vista und höher: Diese Eigenschaft ist schreibgeschützter Wert für WIA_CATEGORY_FOLDER- und WIA_CATEGORY_FINISHED_FILE-Elemente und Lese-/Schreibzugriff für alle anderen WIA 2.0-Elementkategorien. Gültige Werte: WIA_PROP_LIST

WIA_DEPTH_AUTO ist als 0 Bit pro Pixel definiert, und es handelt sich um einen neuen Eigenschaftswert, der für die WIA_IPA_DEPTH definiert ist. Dieser Wert gilt für alle programmierbaren Bilddatenquellenelemente, einschließlich Flatbed und Feeder. Wenn WIA_DEPTH_AUTO vom WIA-Minitreiber unterstützt wird, kann der WIA-Anwendungsclient WIA_IPA_DEPTH auf diesen Wert festlegen, um die automatische Farberkennung auf dem Gerät zu aktivieren. Wenn WIA_DEPTH_AUTO festgelegt ist, muss der WIA-Minitreiber WIA_IPA_DATATYPE für dasselbe Element aktualisieren, um WIA_DATA_AUTO (was ein unterstützter Wert sein muss, wenn das Gerät automatische Farben unterstützt).

WIA_DEPTH_AUTO ist ein optionaler Wert, der jedoch erforderlich wird, wenn WIA_DATA_AUTO für WIA_IPA_DATATYPE unterstützt wird.

WIA_IPA_FILENAME_EXTENSION
PictureFilenameExtension

Enthält die Dateinamenerweiterung für ein bestimmtes Dateiformat. Der Minidriver erstellt und verwaltet diese Eigenschaft.

Optional für alle übertragungsfähigen WIA 2.0-Elemente.

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

Der Treiber aktualisiert diese Eigenschaft, um den aktuellen Wert der WIA_IPA_FORMAT-Eigenschaft widerzuspiegeln.

Wenn beispielsweise WIA_IPA_FORMAT WiaImgFmt_JPEG ist, sollte WIA_IPA_FILENAME_EXTENSIONjpg sein. Wenn WIA_IPA_FORMAT WiaImgFmt_BMP ist, sollte WIA_IPA_FILENAME_EXTENSION BMP sein.

Hinweis:
Die Dateinamenerweiterung enthält den Punkt nicht.

 

Diese Eigenschaft wird für Treiber empfohlen, die Standardformate unterstützen, und ist für Treiber erforderlich, die benutzerdefinierte Formate implementieren. Es informiert die Anwendung über die richtige Dateinamenerweiterung, die während der Übertragung von privat formatierten Dateien verwendet werden soll. Wenn die A. Datum Corporation beispielsweise einen WIA-Treiber erstellt hat, der eine Datei in einem neuen Format übertragen hat, könnte das Unternehmen eine Erweiterung von "adc" angeben. Dies ermöglicht Es Anwendungen, Daten in diesem Format in eine Datei zu übertragen und einen Dateinamen wie myfile.adc zu erstellen, was für andere Benutzer nützlich ist, die die neue Erweiterung verstehen.

WIA_IPA_FORMAT
PictureFormat

Enthält das aktuelle Format des Bilds, das übertragen werden soll.

Eine Anwendung liest diese Eigenschaft, um das Format des Bilds zu bestimmen, das sie empfangen soll. Eine Anwendung schreibt diese Eigenschaft, um das Format festzulegen. Diese Eigenschaft hängt von der WIA_IPA_TYMED-Eigenschaft ab. Der Minidriver erstellt und verwaltet diese Eigenschaft.

Wenn das Gerät nur auf einen einzelnen Wert festgelegt werden kann, erstellen Sie einen WIA_PROP_LIST Typ, und platzieren Sie den gültigen Wert darin.

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

In der folgenden Tabelle sind die Konstanten aufgeführt, die mit dieser Eigenschaft gültig sind. Das Sternchen * gibt an, dass die Konstante in Windows Vista nicht unterstützt wird. (Sie ist nur über die IWiaItem-Schnittstelle verfügbar.) Das doppelte Sternchen ** gibt an, dass die Konstante in Windows Server 2003 oder Windows Vista nicht unterstützt wird. Das V-Symbol gibt an, dass die Konstante nur in Windows Vista und höher unterstützt wird. (Es ist nur über die IWiaItem2-Schnittstelle verfügbar.)

Format BESCHREIBUNG
WiaAudFmt_AIFF AIFF-Audioformat
WiaAudFmt_MP3 MP3-Audioformat
WiaAudFmt_WAV WAV-Audioformat
WiaAudFmt_WMA WMA-Audioformat
WiaImgFmt_ASF** ASF-Videoformat
WiaImgFmt_AVI** AVI-Videoformat
WiaImgFmt_BMP Windows-Bitmap mit einer Headerdatei
WiaImgFmt_CIFF* Kamerabilddateiformat
WiaImgFmt_DPOF DPOF-Druckformat
WiaImgFmt_EMF Erweiterte Windows-Metadatei
WiaImgFmt_EXEC Ausführbare Datei
WiaImgFmt_EXIF Austauschbares Dateiformat
WiaImgFmt_FLASHPIX FlashPix-Format
WiaImgFmt_GIF GIF-Bildformat
WiaImgFmt_HTML HTML-Format
WiaImgFmt_ICO Windows-Symboldateiformat
WiaImgFmt_JBIGV Das JBIG-Format (Joint Bi-level Image Experts Group).
WiaImgFmt_JPEG KOMPRIMIERTES JPEG-Format
WiaImgFmt_JPEG2K KOMPRIMIERTES JPEG 2000-Format
WiaImgFmt_JPEG2KX KOMPRIMIERTES JPEG 2000-Format
WiaImgFmt_MEMORYBMP Windows-Bitmap ohne Headerdatei
WiaImgFmt_PDFAV Das FORMAT PDF/A (ISO/CD 19005-1).
WiaImgFmt_MPG** MPEG-Videoformat
WiaImgFmt_PHOTOCD Eastman-Kodak-Dateiformat
WiaImgFmt_PICT Apple-Dateiformat
WiaImgFmt_PNG W3C PNG-Format
WiaImgFmt_RAW Rohformat nur für Datenübertragungen
WiaImgFmt_RAWRGB Unformatiertes RGB-Format
WiaImgFmt_RTF Format der Rich-Text-Datei
WiaImgFmt_SCRIPT Skriptdatei
WiaImgFmt_TIFF Tag Image File Format
WiaImgFmt_TXT Textdatei
WiaImgFmt_UNICODE16 UNICODE-16-Bit-Codierung
WiaImgFmt_WMF Windows-Metadatei
WiaImgFmt_XML XML-Datei:
WiaImgFmt_XPSV XPS-Paketformat

 

Hinweis:
Wenn diese Eigenschaft entweder WiaImgFmt_PDFA oder WiaImgFmt_XPS ist und WIA_IPA_COMPRESSION WIA_COMPRESSION_NONE ist; der letztere Wert bedeutet, dass der Komprimierungsmodus nicht definiert ist und der Scanner sich für einen Modus entscheiden muss.

 
WIA_IPA_FULL_ITEM_NAME
PictureFullItemName

Enthält den vollständigen Elementnamen (den Elementnamen zusammen mit Pfadinformationen). Der vollständige Elementname ist mit dem bstrFullItemName-Parameter der WiasCreateDrvItem-Dienstdienstprogrammfunktion identisch. Eine Anwendung liest diese Eigenschaft, um zu bestimmen, welches Element derzeit verwendet wird und wo sich dieses Element in der Elementstruktur befindet. Jedes Element sollte einen eindeutigen Namen haben. Anwendungen verwenden häufig den vollständigen Elementnamen, um nach Elementen in der Elementstruktur zu suchen. Der WIA-Dienst erstellt und verwaltet diese Eigenschaft.

Erforderlich für alle WIA 2.0-Elemente.

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

WIA_IPA_GAMMA_CURVES
PictureGammaCurves

Diese Eigenschaft ist für die zukünftige Verwendung reserviert und wird derzeit nicht implementiert.

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

WIA_IPA_ICM_PROFILE_NAME
PictureIcmProfileName

Enthält den ICM-Profilnamen, der zum ordnungsgemäßen Decodieren des Images erforderlich ist. Eine Anwendung liest diese Eigenschaft, um das ICM-Profil zu bestimmen, das bei der Verarbeitung des Images verwendet werden soll. Der WIA-Dienst erstellt und verwaltet diese Eigenschaft basierend auf dem Eintrag ICMProfiles in der Treiberinstallationsdatei.

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

WIA_IPA_ITEM_CATEGORY
PictureItemCategory

Wird nur in Windows Vista und höher unterstützt.

WIA 2.0-Elemente werden in Kategorien gruppiert, die definieren, wie ein IWiaItem2 behandelt oder verwendet werden soll. Wenn das Element beispielsweise einen Feeder darstellt, sollte die Anwendung erwarten, dass es die erforderlichen Dokumentzuführungseigenschaften enthält und wie ein Dokumenteinzug funktioniert. Wenn das Element eine fertige Datei darstellt, sollte es von einer WIA 2.0-Anwendung auf diese Weise behandelt werden, vorausgesetzt, die Daten sind statisch und befinden sich auf dem Gerät. (Die Regeln für die einzelnen Elemente werden in ihren individuellen Spezifikationsdokumenten definiert.)

Erforderlich für alle WIA 2.0-Elemente.

Typ: VT_CLSID, Zugriff: Schreibgeschützt, Gültige Werte: Elementkategorie-GUIDs

WIA_IPA_ITEM_FLAGS
PictureItemFlags

Enthält die beschreibenden Flags für ein WIA-Element. Die Elementflags sind mit denen im lObjectFlags-Parameter der wiasCreateDrvItem-Diensthilfsprogrammfunktion identisch. Der WIA-Dienst erstellt und verwaltet diese Eigenschaft.

Eine Anwendung liest diese Eigenschaft, um die beschreibenden Flagwerte des Elements zu bestimmen.

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

Die folgende Tabelle enthält die Flags, 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. (Es ist nur über die IWiaItem-Schnittstelle verfügbar.) Ein doppeltes Sternchen ** gibt an, dass das Flag in Windows Server 2003 oder 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. (Es ist nur über die IWiaItem2-Schnittstelle verfügbar.)

Flag Definition
WiaItemTypeAnalyze* Dieses Element unterstützt die IWiaItem::AnalyzeItem-Methode (in der Platform SDK-Dokumentation beschrieben). Dieses Element unterstützt auch die automatische Generierung untergeordneter Elemente. Diese Funktion ist nützlich für die Regionserkennung oder Seitenkomposition.
WiaItemTypeAudio Dieses Element unterstützt Audio. Dieses Flag ist nur für Elemente gültig, für die auch das WiaItemTypeFile-Flag festgelegt ist.
WiaItemTypeBurst* Nur für Ordner. Dieses Flag gibt an, dass die Bilder in diesem Ordner in einer kontinuierlichen Zeitfolge erstellt wurden.
WiaItemTypeDeleted Dieses Element ist zum Löschen markiert, dieses Element wurde gelöscht, dieses Element ist nicht vorhanden, oder der Inhalt dieses Elements ist ungültig.
WiaItemTypeDocumentV Dieses Element ist eine Dokumentdatei in einem der Dokumentformate, die die WIA_IPA_FORMAT-Eigenschaft enthält. (Diese Formate umfassen Nichtimagedateien, z. B. .txt, .htm und .doc-Dateien.)
WiaItemTypeDevice Dieses Element stellt ein verbundenes Gerät dar.
WiaItemTypeDisconnected Dieses Element stellt ein nicht verbundenes Gerät dar.
WiaItemTypeFile Das Element unterstützt Dateiübertragungen.
WiaItemTypeFolder Das Element ist ein Ordner.
WiaItemTypeFree Das Element ist nicht initialisiert oder wurde gelöscht.
WiaItemTypeGenerated Dieses Element wurde von einer Anwendung oder vom Treiber generiert.
WiaItemTypeHasAttachments* Dieses Element unterstützt Anlagen und enthält derzeit Anlagen.
WiaItemTypeHPanorama* Dieses Element stellt ein horizontales Panoramabild dar. Dieses Flag ist nur für Elemente gültig, für die auch das WiaItemTypeFolder-Flag festgelegt ist.
WiaItemTypeImage Das Element ist eine Bilddatei. Dieses Flag ist nur für Elemente gültig, für die auch das WiaItemTypeFile-Flag festgelegt ist.
WiaItemTypeProgrammableDataSourceV Das Element ist eine programmierbare Datenquelle und folgt einer Reihe vordefinierter Konfigurationsregeln, die auf WIA_IPA_ITEM_CATEGORY basieren.
WiaItemTypeRootV Dieses Element ist das Stammelement, das für alle Vom Gerät unterstützten Featureelemente übergeordnet ist.
WiaItemTypeStorage Dieses Flag gibt zusätzlichen Speicher für Ordnerelemente an. WIA-Treiber geben ihre Elemente in Bezug auf Images und Ordner an. Es sind keine WIA-Eigenschaften vorhanden, die die Merkmale eines Speicherelements beschreiben (z. B. verbleibender Speicherplatz, Schreibgeschwindigkeit oder Medientyp). Anbieterspezifische Eigenschaften, die diese Informationen verfügbar machen, können hinzugefügt werden. Auf diese Eigenschaften kann nur für Anwendungen oder Erweiterungen zugegriffen werden, die geschrieben wurden, um sie zu erkennen.
WiaItemTypeTransfer Dieses Element kann zum Übertragen von Daten verwendet werden.
WiaItemTypeTwainCapabilityPassThrough Dieser Typ gibt an, dass das WIA-Gerät TWAIN-Funktionsdaten von der TWAIN-Kompatibilitätsebene empfangen kann. Wenn dieser Typ festgelegt ist, wird jede TWAIN-Funktion, die von der TWAIN-Kompatibilitätsebene nicht verstanden wird, an denWIA-Treiber übergeben. Dies ist nur für das Stammelement gültig.
WiaItemTypeVideo** Dieses Element unterstützt das Streaming von Videos.
WiaItemTypeVPanorama* Dieses Element stellt ein vertikales Panoramabild dar. Dieses Flag ist nur für Elemente gültig, für die auch das WiaItemTypeFolder-Flag festgelegt ist.

 

Einige dieser Flags sind für WIA 2.0-Elemente gemäß der Kategorie des Elements erforderlich oder optional, wie in dieser Tabelle dargestellt.

Kategorie des Elements Erforderlich Optional
WIA_CATEGORY_ROOT WiaItemTypeRoot WiaItemTypeFolder WiaItemTypeDevice WiaItemTypeDisconnected
WIA_CATEGORY_FLATBED WiaItemTypeProgrammableDataSource WiaItemTypeTransfer WiaItemTypeImage WiaItemTypeFile WiaItemTypeFolder (Wenn mehrere Scanregionenelemente unterstützt werden, ist dieses Flag nur für das WIA_CATEGORY_FLATBED Stammelement optional.)
WIA_CATEGORY_FEEDER WIA_CATEGORY_FEEDER_FRONT WIA_CATEGORY_FEEDER_BACK WiaItemTypeProgrammableDataSource WiaItemTypeTransfer WiaItemTypeImage WiaItemTypeFile WiaItemTypeFolder (Wenn WIA_CATEGORY_FEEDER_FRONT und WIA_CATEGORY_FEEDER_BACK Elemente vorhanden sind, ist dieses Flag nur für das WIA_CATEGORY_FEEDER Stammelement optional.)
WIA_CATEGORY_FILM (Stamm) WiaItemTypeProgrammableDataSource WiaItemTypeTransfer WiaItemTypeImage WiaItemTypeFile WiaItemTypeFolder Keine
WIA_CATEGORY_FILM (Kinder) WiaItemTypeProgrammableDataSource WiaItemTypeTransfer WiaItemTypeImage WiaItemTypeFile Keine
WIA_CATEGORY_FOLDER WiaItemTypeStorage WiaItemTypeFolder WiaItemTypeDeleted
WIA_CATEGORY_FINISHED_FILE WiaItemTypeFile WiaItemTypeTransfer WiaItemTypeImage WiaItemTypeAudio WiaItemTypeDeleted

 

WIA_IPA_ITEM_NAME
PictureItemName

Enthält den Elementnamen. Eine Anwendung liest diese Eigenschaft, um zu bestimmen, welches Element gerade verwendet wird. Jedes Element hat einen eindeutigen Namen. Der WIA-Dienst erstellt und verwaltet diese Eigenschaft.

Erforderlich für alle WIA 2.0-Elemente.

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

WIA_IPA_ITEM_SIZE
PictureItemSize

Enthält die aktuelle Größe der Daten, die dem Element zugeordnet sind, in Bytes. Der Minidriver erstellt und verwaltet diese Eigenschaft.

Enthält die Gesamtgröße der übertragenen Daten. Wenn dieser Wert 0 ist, bedeutet dies, dass der Minitreiber keine Informationen über die genaue Größe der Daten hat. (Dies ist üblich für komprimierte Daten.) Eine Anwendung liest diesen Wert, um die Größe des Erwerbs zu bestimmen, bevor er erfolgt. Der WIA-Dienst liest diese Eigenschaft, um die Zuweisung von Arbeitsspeicher für Datenübertragungen zu unterstützen. Weitere Informationen finden Sie unter Übertragen von Daten an eine WIA-Anwendung , wenn die Eigenschaft auf Null festgelegt ist und TYMED für eine Dateiübertragung konfiguriert ist, weist der WIA-Dienst keinen Arbeitsspeicher für den WIA-Minitreiber zu.

Erforderlich für alle übertragungsfähigen WIA 2.0-Elemente.

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

WIA_IPA_ITEM_TIME
PictureItemTime

Enthält den Zeitpunkt, zu dem das Bild ursprünglich erfasst wurde. Der Minidriver erstellt und verwaltet diese Eigenschaft. Diese Eigenschaft sollte als Vektor von acht WORD-Werten in Form einer SYSTEMTIME-Struktur gemeldet werden (beschrieben in der Platform SDK-Dokumentation).

Optional für alle WIA 2.0-Elemente.

Typ: VT_UI2 | VT_VECTOR Access: Lese-/Schreibzugriff oder Schreibschutz, Gültige Werte: WIA_PROP_NONE

WIA_IPA_ITEMS_STORED
PictureItemItemsStored

Wird nur in Windows Vista und höher unterstützt.

Gibt an, wie viele Elemente im WIA_CATEGORY_FOLDER Element gespeichert werden.

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

WIA_IPA_MIN_BUFFER_SIZE
PictureMinBufferSize

Gibt die minimale Puffergröße an, die bei Datenübertragungen verwendet wird. Wenn die Datenübertragung über einen Rückrufmechanismus durchgeführt wird, kann der Eigenschaftswert bis zu 64 KB betragen. Wenn die Übertragung jedoch auf eine Datei erfolgt, ist der Eigenschaftswert die Anzahl der Bytes, die zum Übertragen einer Datenseite gleichzeitig erforderlich sind. Der Minidriver erstellt und verwaltet diese WIA-Eigenschaft.

Optional für alle übertragungsfähigen WIA 2.0-Elemente.

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

WIA_IPA_NUMBER_OF_LINES
PictureNumberOfLines

Enthält die Anzahl der im Bild enthaltenen Zeilen (die vertikale Höhe des Bilds in Pixel). Der Minidriver erstellt und verwaltet diese Eigenschaft.

Optional für alle WIA 2.0-Elemente.

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

WIA_IPA_PIXELS_PER_LINE
PicturePixelsPerLine

Enthält die Anzahl von Pixeln in jeder Zeile des Bilds (die Breite des Bilds in Pixeln). Der Minidriver erstellt und verwaltet diese Eigenschaft.

Optional für alle WIA 2.0-Elemente.

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

WIA_IPA_PLANAR
PicturePlanar

Diese Eigenschaft wird in Windows Vista und höher nicht unterstützt.

Enthält Optionen zum Packen von Bilddaten. Der Minidriver erstellt und verwaltet diese Eigenschaft.

Eine Anwendung liest diese Eigenschaft, um die Bildverpackungsoptionen zu bestimmen, oder legt die aktuellen Bildverpackungsoptionen fest.

Typ: VT_I4; Zugriff: Lese-/Schreibzugriff; Gültige Werte: WIA_PROP_LIST. Wenn das Gerät nur auf einen einzelnen Wert festgelegt werden kann, erstellen Sie einen WIA_PROP_LIST Typ, und platzieren Sie den gültigen Wert darin.

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

Wert Definition
WIA_PACKED_PIXEL Bilddaten sind im gepackten Pixelformat.
WIA_PLANAR Bilddaten haben das planare Format.

 

WIA_IPA_PREFERRED_FORMAT
PicturePreferredFormat

Enthält das bevorzugte Format für Bilder, die von diesem Minidriver übertragen werden. Der Minidriver erstellt und verwaltet diese Eigenschaft.

Erforderlich für alle übertragungsfähigen WIA 2.0-Elemente.

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

WIA_IPA_PROP_STREAM_COMPAT_ID
PicturePropStreamCompatId

Gibt eine CLSID an, die einen Satz von Geräteeigenschaftswerten darstellt. Wenn ein Gerätetreiber dieses Feature implementiert, verwenden Anwendungen diese Eigenschaft, um zu bestimmen, ob das Gerät eine Reihe von Werten unterstützt.

Typ: CLSID, Access: Schreibschutz, Gültige Werte: WIA_PROP_LIST

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

Wert Definition
WiaImgFmt_BMP MicrosoftWindows-Bitmap mit einer Headerdatei
WiaImgFmt_EMF Erweiterte Windows-Metadatei
WiaImgFmt_EXIF Austauschbares Dateiformat
WiaImgFmt_FLASHPIX FlashPix-Format
WiaImgFmt_GIF GIF-Bildformat
WiaImgFmt_ICO Windows-Symboldateiformat
WiaImgFmt_JPEG KOMPRIMIERTES JPEG-Format
WiaImgFmt_PHOTOCD Eastman-Kodak-Dateiformat
WiaImgFmt_PNG W3C PNG-Format
WiaImgFmt_MEMORYBMP Windows-Bitmap ohne Headerdatei
WiaImgFmt_TIFF Tag Image File Format
WiaImgFmt_WMF Windows-Metadatei

 

WIA_IPA_RAW_BITS_PER_CHANNEL
PictureRawBitsPerChannel

Wird nur in Windows Vista und höher unterstützt.

Enthält die Anzahl der Bits in jedem Kanal. Diese Eigenschaft sollte als Vektor von so vielen BYTE-Werten gemeldet werden, wie Kanäle vorhanden sind. Dabei entspricht das erste BYTE der Anzahl der Bits im ersten Kanal, das zweite Byte der Anzahl der Bits im zweiten Kanal usw. Gemäß WIA_IPA_CHANNELS_PER_PIXEL müssen so viele Einträge vorhanden sein, wie Kanäle vorhanden sind. Der Treiber legt diese Eigenschaft fest, wenn die Anwendung zu WiaImgFmt_RAW wechselt. Für die bekannten Untertypen gibt es so viele Einträge, wie in der Tabelle unter WIA_IPA_RAW_SUBTYPE aufgeführt sind.

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

WIA_IPA_REGION_TYPE
PictureRegionType

Diese Eigenschaft ist für die zukünftige Verwendung reserviert und wird derzeit nicht implementiert.

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

WIA_IPA_SUPPRESS_PROPERTY_PAGE
PictureSuppressPropertyPage

Gibt an, ob die allgemeinen Eigenschaftenseiten für Elemente auf dem Gerät unterdrückt werden sollen.

Diese Eigenschaft ist unter Windows XP und höher verfügbar.

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. Das Sternchen * gibt an, dass die Konstante mit Windows Vista und höher ungültig ist. (Sie ist nur über die IWiaItem-Schnittstelle verfügbar.)

Dauerhaft BESCHREIBUNG
WIA_PROPPAGE_CAMERA_ITEM_GENERAL* Unterdrücken Sie die Eigenschaftenseite des allgemeinen Elements für eine Kamera.
WIA_PROPPAGE_SCANNER_ITEM_GENERAL Unterdrücken Sie die Eigenschaftenseite des allgemeinen Elements für einen Scanner.

 

WIA_IPA_TYMED
PictureTymed

Diese Eigenschaft enthält die Einstellung für die Übertragungsmethode. Der Minidriver erstellt und verwaltet diese Eigenschaft.

Eine Anwendung liest diese Eigenschaft, um die Datenübertragungsmethode des Minitreibers zu bestimmen.

Erforderlich für alle übertragungsfähigen WIA 2.0-Elemente.

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

Die folgende Tabelle enthält die Konstanten, die für diese Eigenschaft gültig sind. Das Sternchen * gibt Konstanten an, die mit Windows Vista und höher nicht gültig sind. (Sie sind nur über die IWiaItem-Schnittstelle verfügbar.)

Transfertyp BESCHREIBUNG
TYMED_CALLBACK* Übertragen eines Bilds in Bändern in den Arbeitsspeicher.
TYMED_MULTIPAGE_CALLBACK* Übertragen Sie mehrere Bilder in Bändern in den Arbeitsspeicher.
TYMED_FILE Übertragen eines Bilds in eine Datei.
TYMED_MULTIPAGE_FILE Übertragen eines Bilds in eine Datei.

 

WIA_IPA_UPLOAD_ITEM_SIZE
PictureItemUploadItemSize

Wird nur in Windows Vista und höher unterstützt.

Gibt die Anzahl der Bytes an, die für ein Element hochgeladen werden sollen.

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

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client)
Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)
Windows Server 2008 [nur Desktop-Apps]
Header
Wiadef.h