Freigeben über

WIA_IPS_CUR_INTENT

  • Artikel

Die WIA_IPS_CUR_INTENT-Eigenschaft enthält die aktuellen Einstellungen für die beabsichtigte Verwendung eines Bilds durch eine Anwendung. Der WIA-Minitreiber erstellt und verwaltet diese Eigenschaft.

Eigenschaftstyp: VT_I4

Gültige Werte: WIA_PROP_FLAG

Zugriffsrechte: Lese-/Schreibzugriff

Bemerkungen

Ein Treiber verwendet die Absichtseinstellungen, um Elementeigenschaften basierend auf der beabsichtigten Verwendung eines Bilds einer Anwendung vorab festzulegen. Diese Eigenschaften können z. B. die maximale Qualität und die mindeste Größe umfassen.

Die folgende Tabelle enthält die Imagetypflags und deren Definitionen. Diese Flags werden verwendet, um festzulegen, welcher Bildtyp vorgesehen ist: Farbe, Graustufen usw.

Bildtypflags Definition
WIA_INTENT_IMAGE_TYPE_COLOR Die Anwendung beabsichtigt, das Gerät auf einen Farbscan vorzubereiten.
WIA_INTENT_IMAGE_TYPE_GRAYSCALE Die Anwendung beabsichtigt, das Gerät für eine Graustufenüberprüfung vorzubereiten.
WIA_INTENT_IMAGE_TYPE_TEXT Die Anwendung beabsichtigt, das Gerät für das Scannen von Text vorzubereiten.
WIA_INTENT_IMAGE_TYPE_MASK Dieses Flag ist eine Maske für alle Bildtypflags.
WIA_INTENT_NONE Standardwert. Es wird keine Absicht angegeben.

Die folgende Tabelle enthält die Bildgrößen- und Qualitätsflags und deren Definitionen. Diese Flags werden verwendet, um die Größe und Qualität einer Bildüberprüfung festzulegen.

Bildgröße/Qualitätsflags Definition
WIA_INTENT_BEST_PREVIEW Die Anwendung beabsichtigt, das Gerät für das Scannen einer Vorschau vorzubereiten.
WIA_INTENT_MAXIMIZE_QUALITY Die Anwendung beabsichtigt, das Gerät auf das Scannen eines qualitativ hochwertigen Bilds vorzubereiten.
WIA_INTENT_MINIMIZE_SIZE Die Anwendung beabsichtigt, das Gerät für das Scannen eines Bilds vorzubereiten, das zu einer kleinen Überprüfung führt.
WIA_INTENT_SIZE_MASK Dieses Flag ist eine Maske für alle Größen- und Qualitätsflags.

Der Treiber wählt die Bittiefe in Punkt pro Zoll und andere Einstellungen aus, die für die ausgewählte Absicht geeignet sind. Die Anwendung muss die aktuellen Einstellungen lesen, um zu bestimmen, welche Eigenschaften geändert wurden.

Eine Anwendung legt die WIA_IPS_CUR_INTENT-Eigenschaft so fest, dass die WIA-Eigenschaften für bestimmte Erfassungsabsichten automatisch festgelegt werden. Beachten Sie, dass Flags mit einem bitweisen OR-Operator kombiniert werden können, ein Bild kann jedoch nicht sowohl Graustufen als auch Farbe aufweisen.

WIA_IPS_CUR_INTENT ist für alle Elemente mit Aktivierter Bilderfassung erforderlich; sie ist nicht für Speicherelemente oder gespeicherte Imageelemente verfügbar.

Anforderungen

Header: wiadef.h (include Wiadef.h)