WIA_DPS_SCAN_AVAILABLE_ITEM
Die WIA_DPS_SCAN_AVAILABLE_ITEM-Eigenschaft stellt den Namen der Eingabequelle für einen Pushscanvorgang bereit, den die Anwendung unter Programmsteuerung ausführt. Der WIA-Minitreiber erstellt und verwaltet diese Eigenschaft.
Eigenschaftstyp: VT_BSTR
Gültige Werte: WIA_PROP_NONE
Zugriffsrechte: Schreibgeschützt
Bemerkungen
In Windows 7 und höher ist WIA_DPS_SCAN_AVAILABLE_ITEM eine optionale Eigenschaft des Stammelements in der WIA-Elementstruktur eines WIA-Scannergeräts. Eine Anwendung kann diese Eigenschaft abfragen, um die Eingabequelle (Flachbett, automatischer Dokumenteinzug oder Filmscanadapter) für die Überprüfung oder den Speicherort für die Datenübertragung zu bestimmen.
Einige WIA-Scannergeräte ermöglichen es einem Benutzer, eine Eingabequelle für einen Scanauftrag im Frontbereich des Geräts auszuwählen oder implizit eine Eingabequelle auszuwählen, z. B. durch Einfügen eines Dokuments in einen Feeder des Geräts. Wenn der Benutzer die Schaltfläche Start-Scan auf dem Gerät drückt, muss die Anwendung ermitteln, welche Eingabequelle der Benutzer ausgewählt hat, damit sie einen Scanvorgang für diese Quelle initiieren kann.
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.
Das Stammelement in einer WIA-Struktur enthält mindestens ein untergeordnetes Element (Flachbettelement, Feederelement und Filmelement), die Eingabequellen auf dem Gerät darstellen. Jedes dieser Elemente kann ein übergeordnetes Element zu untergeordneten Elementen sein, die Teile oder Regionen der Eingabequelle darstellen. Ein Flachbettelement, das ein untergeordnetes Element des Stammelements ist und das Flachbett als Ganzes darstellt, kann untergeordnete Elemente aufweisen (die auch Flachbettelemente sind), die die einzelnen Regionen der Flachbettoberfläche darstellen. Ein Feederelement, das ein untergeordnetes Element des Stammelements ist und einen automatischen Dokumenteinzug darstellt, kann untergeordnete Elemente aufweisen, die die Scanner für die Vorder- und Rückseite der Dokumentseiten darstellen, die den Feeder durchlaufen. Ein Filmelement, das ein untergeordnetes Element des Stammelements ist und den Filmscanadapter als Ganzes darstellt, kann untergeordnete Elemente aufweisen (die auch Filmelemente sind), die einzelne Filmrahmen darstellen. Je nach dem vom Benutzer angeforderten Überprüfungsvorgang kann die WIA_DPS_SCAN_AVAILABLE_ITEM-Eigenschaft einem Flachbett, einem Feeder oder einem Filmelement den Namen geben, das ein untergeordnetes Element des Stamms ist, oder ein untergeordnetes Element eines dieser Elemente benennen. Weitere Informationen zu diesen Elementen finden Sie unter WIA-Elementkategorien.
Wenn ein Scanereignis auftritt, legt der Treiber sofort den wert der WIA_DPS_SCAN_AVAILABLE_ITEM Eigenschaft auf einen WIA-Elementnamen fest (genau wie von der WIA_IPA_ITEM_NAME-Eigenschaft des Elements gemeldet), der die Eingabequelle identifiziert, aus der der Scanauftrag verfügbar ist, sofern diese Informationen bekannt sind. Andernfalls legt der Treiber den Eigenschaftswert auf eine leere Zeichenfolge fest, wenn die Eingabequelle unbekannt ist. Wenn die Anwendung das Scanereignis nutzt, ändert sich der Status des Scanereignisses von signalisiert in nicht signalisiert, und der Treiber setzt den WIA_DPS_SCAN_AVAILABLE_ITEM-Eigenschaftswert auf eine leere Zeichenfolge zurück.
Weitere Informationen zu dieser Eigenschaft finden Sie unter Identifizieren der Eingabequelle für ein Scanereignis.
Anforderungen
Header: wiadef.h (include Wiadef.h)