Allgemeine WIA-Elementeigenschaftskonstanten

Die folgenden Geräteeigenschaftskonstanten müssen von allen Schnittstellen IWiaItem, IWiaItem2 und IWiaDrvItem-Schnittstelle 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 wiaItemPropertyId-Enumerationstyps. Der entsprechende Membername aus dieser Skriptenumeration 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 und ob das Element gelöscht wird.
Erforderlich für alle WIA 2.0-Elemente.
Typ: VT_I4; Lesen/Schreiben oder Schreibzugriff, abhängig von der Fähigkeit des Elements, seine Zugriffsrechte zu ändern; Gültige Werte: WIA_PROP_FLAG
Die folgende Tabelle enthält die fünf Flags, die mit dieser Eigenschaft gültig sind.
Zugriffsrecht Beschreibung
WIA_ITEM_READ Das Element verfügt über schreibgeschützten Zugriff.
WIA_ITEM_WRITE Das Element verfügt nur über Schreibzugriff.
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 durch reserviert und wird derzeit nicht implementiert.

Typ: VT_I4, Zugriff: Schreibgeschützte, 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 Minitreiber erstellt und verwaltet diese Eigenschaft.

Erforderlich für alle WIA 2.0-Erfassungs- oder gespeicherten Imageelemente.

Typ: VT_I4, Zugriff: Schreibgeschützte, 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 Minitreiber 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 arbeitsspeicher für den Minitreiber während der Datenübertragung zuzuweisen.

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

Typ: VT_I4, Zugriff: Schreibgeschützte, gültige Werte: WIA_PROP_NONE

[!Note]
Die WIA_IPA_BUFFER_SIZE -Eigenschaft enthält die Minimale Datenmenge, die eine Anwendung zu einem beliebigen Zeitpunkt anfordern kann. Je größer der Puffer, desto größer sind die Anforderungen an das Gerät. Dadurch kann das Gerät langsam und nicht reagieren, die Gesamtleistung des Systems beeinträchtigen und übermäßige Ressourcen verbrauchen. 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 abgleichen.
WIA_IPA_BYTES_PER_LINE
PictureBytesPerLine

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

Optional für alle WIA 2.0-Elemente.

Typ: VT_I4, Zugriff: Schreibgeschützte, 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 Minitreiber erstellt und verwaltet diese Eigenschaft.

Erforderlich für alle WIA 2.0-Erfassungs- oder gespeicherten Imageelemente.

Typ: VT_I4, Zugriff: Schreibgeschützte, gültige Werte: WIA_PROP_NONE

WIA_IPA_COLOR_PROFILE
PictureColorProfile

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

Typ: VT_I4, Zugriff: Schreibgeschützte, gültige Werte: WIA_PROP_NONE

WIA_IPA_COMPRESSION
PictureCompression

Enthält den aktuellen verwendeten Komprimierungstyp. Der Minitreiber 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: Lesen/Schreiben, Gültige Werte: WIA_PROP_LIST

Die folgende Tabelle enthält die Konstanten, die mit dieser Eigenschaft gültig sind. Das Symbol V gibt an, dass die Konstante nur in Windows Vista und höher unterstützt wird. (Sie 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 Gruppen-3-Komprimierung
WIA_COMPRESSION_G4 Gruppen-4-Komprimierung
WIA_COMPRESSION_JPEG JPEG-Komprimierung.
WIA_COMPRESSION_JBIGV JBIG-Komprimierung.
WIA_COMPRESSION_JPEG2KV JPEG 2000-Komprimierung.
WIA_COMPRESSION_PNGV PNG-Komprimierung.

[!Note]

Wenn diese Eigenschaft WIA_COMPRESSION_NONE ist und WIA_IPA_FORMAT entweder WiaImgFmt_PDFA oder WiaImgFmt_XPS ist; WIA_COMPRESSION_NONE bedeutet dann, 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 WIA_IPA_COMPRESSION -Eigenschaft definiert ist. Dieser Wert ist für alle programmierbaren Imagedatenquellelemente gültig, 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 Erkennung des Komprimierungsmodus auf dem Gerät zu aktivieren. WIA_COMPRESSION_AUTO können mit und arbeiten, ohne dass die automatische Vollfarbe 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 Bittiefe 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-Minitreiber nicht mehr erforderlich, WIA_COMPRESSION_AUTO zu WIA_COMPRESSION_AUTO. Wenn er unterstützt wird, darf der WIA-Minitreiber ihn nie 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 Minitreiber 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 Bilds festzulegen, das übertragen werden soll.

Diese Eigenschaft ist für alle WIA 2.0-Elemente erforderlich. Es muss für alle WIA 2.0-Erwerb aktivierten Elemente Lese-/Schreibzugriff und für WIA 2.0-Speicherelemente Schreibzugriff 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ützte Eigenschaft für WIA_CATEGORY_FOLDER und WIA_CATEGORY_FINISHED_FILE Elemente und Lesen/Schreiben 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 Bilddatenquellelemente, 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 (der ein unterstützter Wert sein muss, 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 Vollfarbformat wird mit den 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 aktuell ausgewählten Dithermusters geblendet werden.
WIA_DATA_COLOR_THRESHOLD Identisch mit WIA_DATA_COLOR, außer dass der Schwellenwert beim Scannen der Daten verwendet wird. Farbwerte über dem WIA_IPS_THRESHOLD Wert werden in vollständige Helligkeit konvertiert. Farben unter diesem Wert werden in Schwarz konvertiert.
WIA_DATA_DITHER Scandaten werden mithilfe des aktuell ausgewählten Dithermusters geblendet.
WIA_DATA_GRAYSCALE Scandaten stellen die Intensität dar. Die Palette ist eine feste graue Skala mit gleichem Abstand mit einer Tiefe, die durch WIA_IPA_DEPTH -Eigenschaft angegeben wird.
WIA_DATA_THRESHOLD Der Schwellenwert beträgt ein Bit pro Pixel von Schwarz-Weiß-Daten. Daten über dem aktuellen Wert von WIA_IPS_THRESHOLD werden in Weiß konvertiert. Daten unter diesem Wert werden in Schwarz konvertiert.

Die WIA_IPA_DATATYPE -Eigenschaft 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 eigenschaft WIA_IPA_DATATYPE auf eine Liste zulässiger Werte festlegen, aus der 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 graue Skala mit gleichem Abstand mit einer tiefe, die von der WIA_IPA_DEPTH -Eigenschaft angegeben wird. WIA_IPA_RAW_BITS_PER_CHANNEL muss auf 1 festgelegt werden.
WIA_DATA_RAW_BGR Scandaten sind im BGR-Farbraum (blau-grün-rot) enthalten. Das Vollfarbformat wird mithilfe der 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 Scandaten sind im Farbraum cyan-magenta-yellow (CMY) enthalten. Das Vollfarbformat 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 sind im Farbraum cyan-magenta-yellow-black (CMYK) enthalten. Das Vollfarbformat 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 sind im RGB-Farbraum (Rot-Grün-Blau) enthalten. Das Vollfarbformat 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 Scandaten sind im Farbraum luminance-blue difference-red difference (YUV) enthalten. Das Vollfarbformat 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 Scandaten sind im Farbraum luminance-blue difference-red difference-black (YUVK) enthalten. Das Vollfarbformat 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 Minitreiber erstellt und verwaltet diese Eigenschaft. Eine Anwendung liest diese Eigenschaft, um die Bittiefeeinstellung des Bilds zu bestimmen. Die Anwendung kann diesen Wert möglicherweise 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 für alle WIA 2.0-Erwerb aktivierten Elemente Lese-/Schreibzugriff und für WIA 2.0-Speicherelemente Schreibzugriff sein.

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

WIA_DEPTH_AUTO ist als 0 Bits pro Pixel definiert, und es handelt sich um einen neuen Eigenschaftswert, der für die WIA_IPA_DEPTH definiert ist. Dieser Wert ist für alle programmierbaren Imagedatenquellelemente gültig, 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 auf WIA_DATA_AUTO aktualisieren (dies muss ein unterstützter Wert sein, wenn das Gerät automatische Farben unterstützt).

WIA_DEPTH_AUTO ist ein optionaler Wert, wird jedoch erforderlich, 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 Minitreiber erstellt und verwaltet diese Eigenschaft.

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

Typ: VT_BSTR, Zugriff: Schreibgeschützte, 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_EXTENSION jpgsein. Wenn WIA_IPA_FORMAT WiaImgFmt_BMP ist, sollte WIA_IPA_FILENAME_EXTENSION BMP sein.

[!Note]
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. Er informiert die Anwendung über die richtige Dateinamenerweiterung, die bei 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 die Erweiterung " adc " angeben. Dadurch können Anwendungen Daten in diesem Format in eine Datei übertragen und einen Dateinamen wie myfile.adcerstellen, 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 erhalten soll. Eine Anwendung schreibt diese Eigenschaft, um das Format festzulegen. Diese Eigenschaft hängt von der WIA_IPA_TYMED-Eigenschaft ab. Der Minitreiber 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, Zugriff: Lesen/Schreiben, 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 weder in Windows Server 2003 noch in Windows Vista unterstützt wird. Das Symbol V gibt an, dass die Konstante nur in Windows Vista und höher unterstützt wird. (Sie 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* Format der Kamerabilddatei
WiaImgFmt_DPOF DPOF-Druckformat
WiaImgFmt_EMF Erweiterte Windows Metadatei
WiaImgFmt_EXEC Ausführbare Datei
WiaImgFmt_EXIF Auswechselbares 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 PDF/A-Format (ISO/CD 19005-1).
WiaImgFmt_MPG** MPEG-Videoformat
WiaImgFmt_PHOTOCD EastmanUngsdateiformat
WiaImgFmt_PICT Apple-Dateiformat
WiaImgFmt_PNG W3C PNG-Format
WiaImgFmt_RAW Rohformat nur für Datenübertragungen
WiaImgFmt_RAWRGB RAW RGB-Format
WiaImgFmt_RTF Rich-Text-Dateiformat
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

[!Note]
Wenn diese Eigenschaft entweder WiaImgFmt_PDFA oder WiaImgFmt_XPS ist und WIA_IPA_COMPRESSION WIA_COMPRESSION_NONE wird. der zweite Wert bedeutet, dass der Komprimierungsmodus nicht definiert ist und der Scanner einen Modus festlegen muss.
WIA_IPA_FULL_ITEM_NAME
PictureFullItemName

Enthält den vollständigen Elementnamen (den Elementnamen zusammen mit Pfadinformationen). Der vollständige Elementname entspricht dem bstrFullItemName-Parameter der WiasCreateDrvItem-Diensthilfsprogrammfunktion. 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ützte Werte, Gültige Werte: WIA_PROP_NONE

WIA_IPA_GAMMA_CURVES
PictureGammaCurves

Diese Eigenschaft ist für die zukünftige Verwendung reserviert und 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, das beim Verarbeiten des Bilds verwendet werden soll. Der WIA-Dienst erstellt und verwaltet diese Eigenschaft basierend auf dem ICMProfiles-Eintrag 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 unterteilt, die definieren, wie ein IWiaItem2 behandelt oder verwendet werden soll. Wenn das Element beispielsweise einen Feeder darstellt, sollte die Anwendung davon ausgehen, dass es die erforderlichen Eigenschaften des Dokumentfeeders enthält und wie ein Dokumentfeeder funktioniert. Wenn das Element eine fertige Datei darstellt, sollte eine WIA 2.0-Anwendung sie auf diese Weise behandeln, vorausgesetzt, die Daten sind statisch und befinden sich auf dem Gerät. (Die Regeln für jedes Element werden in den jeweiligen Spezifikationsdokumenten definiert.)

Erforderlich für alle WIA 2.0-Elemente.

Typ: VT_CLSID, Zugriff: Schreibgeschützt, Gültige Werte: GuiDs der Elementkategorie

WIA_IPA_ITEM_FLAGS
PictureItemFlags

Enthält die beschreibenden Flags für ein WIA-Element. Die Elementflags sind identisch mit denen im lObjectFlags-Parameter der Hilfsprogrammfunktion wiasCreateDrvItem. 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 mit dieser Eigenschaft gültig sind. Ein Sternchen * gibt an, dass das Flag in Windows Vista oder höher nicht unterstützt wird. (Sie 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. (Sie ist nur über die IWiaItem2-Schnittstelle verfügbar.)

Flag Definition
WiaItemTypeAnalyze* Dieses Element unterstützt die IWiaItem::AnalyzeItem-Methode (in der Dokumentation zum Plattform-SDK beschrieben). Dieses Element unterstützt auch die automatische Generierung untergeordneter Elemente. Diese Funktion ist nützlich für die Erkennung von Regionen oder die Seitenaufstellung.
WiaItemTypeAudio Dieses Element unterstützt Audio. Dieses Flag ist nur für Elemente gültig, für die auch das Flag WiaItemTypeFile festgelegt ist.
WiaItemTypeBurst* Nur für Ordner. Dieses Flag gibt an, dass die Bilder in diesem Ordner in einer fortlaufenden Zeitsequenz 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 enthält. (Zu diesen Formaten gehören die Formate für Dateien ohne Image, z. B. .txt, .htm und .doc Dateien.)
WiaItemTypeDevice Dieses Element stellt ein verbundenes Gerät dar.
WiaItemTypeDisconnected Dieses Element stellt ein getrenntes 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.
WiaItemTypeHPanoverständlich* Dieses Element stellt ein horizontales Bild dar. Dieses Flag ist nur für Elemente gültig, für die auch das Flag WiaItemTypeFolder festgelegt ist.
WiaItemTypeImage Das Element ist eine Bilddatei. Dieses Flag ist nur für Elemente gültig, für die auch das Flag WiaItemTypeFile festgelegt ist.
WiaItemTypeProgrammableDataSourceV Das Element ist eine programmierbare Datenquelle und folgt einem Satz vordefinierter Konfigurationsregeln, die auf WIA_IPA_ITEM_CATEGORY.
WiaItemTypeRootV Dieses Element ist das Stammelement, bei dem es sich um das übergeordnete Element aller Featureelemente handelt, die vom Gerät unterstützt werden.
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 von 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, werden alle TWAIN-Funktionen, die von der TWAIN-Kompatibilitätsebene nicht verstanden werden, an denWIA-Treiber übergeben. Dies ist nur für das Stammelement gültig.
WiaItemTypeVideo** Dieses Element unterstützt das Streaming von Videos.
WiaItemTypeVPanodio* Dieses Element stellt ein vertikales Bild dar. Dieses Flag ist nur für Elemente gültig, für die auch das Flag WiaItemTypeFolder festgelegt ist.

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

Elementkategorie Erforderlich Optional
WIA_CATEGORY_ROOT WiaItemTypeRoot WiaItemTypeFolder WiaItemTypeDevice WiaItemTypeDisconnected
WIA_CATEGORY_FLATBED WiaItemTypeProgrammableDataSource WiaItemTypeTransfer WiaItemTypeImage WiaItemTypeFile WiaItemTypeFolder (Wenn mehrere Überprüfungsregionselemente unterstützt werden, ist dieses Flag nur für das WIA_CATEGORY_FLATBED 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 vorhanden sind, ist dieses Flag nur für das Stammelement WIA_CATEGORY_FEEDER optional.)
WIA_CATEGORY_FILM (Root) WiaItemTypeProgrammableDataSource WiaItemTypeTransfer WiaItemTypeImage WiaItemTypeFile WiaItemTypeFolder Keine
WIA_CATEGORY_FILM (children) 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 sie derzeit verwendet. 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, Zugriff: Schreibgeschützt, Gültige Werte: WIA_PROP_NONE

WIA_IPA_ITEM_SIZE
PictureItemSize

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

Enthält die Gesamtgröße der übertragenen Daten. Wenn dieser Wert 0 (null) ist, bedeutet dies, dass der Minitreiber keine Informationen über die genaue Größe der Daten hat. (Dies ist bei komprimierten Daten üblich.) Eine Anwendung liest diesen Wert, um die Größe des Kaufs zu bestimmen, bevor er stattfindet. 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 0 festgelegt ist und TYMED für eine Dateiübertragung konfiguriert ist. Der WIA-Dienst weist dem WIA-Minitreiber keinen Arbeitsspeicher zu.

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

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

WIA_IPA_ITEM_TIME
PictureItemTime

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

Optional für alle WIA 2.0-Elemente.

Typ: VT_UI2 | VT_VECTOR Access: Read/Write or Read Only, Valid values: WIA_PROP_NONE

WIA_IPA_ITEMS_STORED
PictureItemItemsStored

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

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

Typ: VT_I4, Zugriff: Lesen/Schreiben, 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 beträgt. Wenn die Übertragung jedoch in eine Datei übertragen wird, entspricht der Eigenschaftswert der Anzahl von Bytes, die zum Übertragen einer Datenseite gleichzeitig erforderlich sind. Der Minitreiber erstellt und verwaltet diese WIA-Eigenschaft.

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

Typ: VT_I4, Zugriff: Schreibgeschützt, 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 Minitreiber erstellt und verwaltet diese Eigenschaft.

Optional für alle WIA 2.0-Elemente.

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

WIA_IPA_PIXELS_PER_LINE
PicturePixelsPerLine

Enthält die Anzahl der Pixel in jeder Zeile des Bilds (die Breite des Bilds in Pixel). Der Minitreiber erstellt und verwaltet diese Eigenschaft.

Optional für alle WIA 2.0-Elemente.

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

WIA_IPA_PLANAR
PicturePlanar

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

Enthält Bilddaten-Packoptionen. Der Minitreiber erstellt und verwaltet diese Eigenschaft.

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

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

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

Wert Definition
WIA_PACKED_PIXEL Bilddaten haben ein gepacktes Pixelformat.
WIA_PLANAR Bilddaten haben das planare Format.

WIA_IPA_PREFERRED_FORMAT
PicturePreferredFormat

Enthält das bevorzugte Format für Bilder, die dieser Minitreiber überträgt. Der Minitreiber erstellt und verwaltet diese Eigenschaft.

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

Typ: CLSID, Access: Schreibgeschützt, 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 einen Satz von Werten unterstützt.

Typ: CLSID, Access: Schreibgeschützt, gültige Werte: WIA_PROP_LIST

Die folgende Tabelle enthält die 12 Konstanten, die für diese 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-Format (Eastman- Und-Eastman-Format)
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 wie Kanäle gemeldet werden, wobei das erste BYTE der Anzahl der Bits im ersten Kanal entspricht, das zweite Byte der Anzahl der Bits im zweiten Kanal und so weiter. Es müssen so viele Einträge wie Kanäle entsprechend der WIA_IPA_CHANNELS_PER_PIXEL. Der Treiber legt diese Eigenschaft fest, wenn die Anwendung zu WiaImgFmt_RAW. Für die bekannten Untertypen gibt es so viele Einträge wie in der Tabelle unter WIA_IPA_RAW_SUBTYPE.

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

WIA_IPA_REGION_TYPE
PictureRegionType

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

Typ: VT_I4, Zugriff: Schreibgeschützt, 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.

Diese Eigenschaft ist ab Windows XP verfügbar.

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

Die folgende Tabelle enthält die Konstanten, die mit dieser 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.)

Konstante Beschreibung
WIA_PROPPAGE_CAMERA_ITEM_GENERAL* Unterdrücken Sie die allgemeine Elementeigenschaftsseite für eine Kamera.
WIA_PROPPAGE_SCANNER_ITEM_GENERAL Unterdrücken Sie die Eigenschaftenseite für allgemeine Elemente für einen Scanner.

WIA_IPA_TYMED
PictureTymed

Diese Eigenschaft enthält die Einstellung der Übertragungsmethode. Der Minitreiber 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: Lesen/Schreiben, Gültige Werte: WIA_PROP_LIST

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

Transfertyp Beschreibung
TYMED_CALLBACK* Übertragen sie ein Bild in Bänder in den Arbeitsspeicher.
TYMED_MULTIPAGE_CALLBACK* Übertragen Sie mehrere Bilder in Bänder in den Arbeitsspeicher.
TYMED_FILE Übertragen sie ein Bild in eine Datei.
TYMED_MULTIPAGE_FILE Übertragen sie ein Bild in eine Datei.

WIA_IPA_UPLOAD_ITEM_SIZE
PictureItemUploadItemSize

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

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

Typ: VT_I4, Zugriff: Lesen/Schreiben, Gültige Werte: WIA_PROP_NONE

Requirements (Anforderungen)

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