Identifizieren der Eingabequelle für ein Scanereignis
Ein Pushscanvorgang ist ein Scanvorgang, den der Benutzer von einem WIA-Scannergerät statt über die Benutzeroberfläche einer AUF einem Desktopcomputer ausgeführten WIA-Anwendung initiiert. Wenn der Benutzer die Schaltfläche Start-Scan auf dem Gerät drückt, erhält die Anwendung ein Scanereignis, um sie zu benachrichtigen, dass der Benutzer einen Scanvorgang angefordert hat. Als Reaktion auf dieses Ereignis kann die Anwendung den Pushscanvorgang auf eine der folgenden beiden Arten ausführen:
Wenn das Gerät die automatisch konfigurierte Überprüfung unterstützt, kann die Anwendung eine Datenübertragung vom automatischen Element anfordern, um ein Bild von der aktuell ausgewählten Eingabequelle (Flachbett, automatischer Dokumenteinzug oder Filmscanadapter) zu erhalten. Daraufhin konfiguriert das Gerät automatisch seine Scaneinstellungen (mit Ausnahme der wenigen Eigenschaften, die nur von der Anwendung konfiguriert werden können, die unter WIA-Eigenschaften werden von einem automatischen Element unterstützt) beschrieben werden, und ruft dann das Image ab.
Die Anwendung kann den Scanvorgang unter direkter Programmsteuerung ausführen. Zunächst konfiguriert die Anwendung die Eigenschaften des WIA-Elements (Flachbettelement, Feederelement oder Filmelement), das die aktuell ausgewählte Eingabequelle darstellt. Als Nächstes ruft die Anwendung ein Bild ab, indem sie eine Datenübertragung von diesem Element anfordert.
Weitere Informationen zu WIA-Elementen finden Sie unter WIA-Elementkategorien.
Wenn ein Scanereignis auftritt, empfängt die Anwendung eine Benachrichtigung, die einen WIA-Ereignisbezeichner (einen GUID-Wert) enthält, um die Art des Ereignisses anzugeben. Der WIA-Minidriver kann einem Ereignis eine benutzerdefinierte WIA-Ereignisbezeichner-GUID zuweisen, oder der Minidriver kann eine der in der Headerdatei Wiadef.h definierten WIA_EVENT_SCAN_XXX GUID-Konstanten verwenden. Weitere Informationen zu diesen Konstanten finden Sie unter WIA-Ereignisbezeichner.
Obwohl der WIA-Ereignisbezeichner für ein Scanereignis Informationen über das Ereignis bereitstellt, gibt er nicht die Eingabequelle an, die für den Scanvorgang verwendet werden soll. Für die automatisch konfigurierte Überprüfung benötigt die Anwendung diese Informationen nicht. Um jedoch eine Überprüfung unter direkter Programmsteuerung durchzuführen, muss die Anwendung wissen, welche Eingabequelle verwendet werden soll. Die Anwendung muss über eine Möglichkeit verfügen, diese Informationen vom Gerät abzurufen, wenn das Gerät über mehr als eine Eingabequelle verfügt und der Benutzer die Eingabequelle vom Gerät anstelle von der Benutzeroberfläche der Anwendung auswählen kann. Beim Auswählen einer Eingabequelle vom Gerät kann der Benutzer die Quelle entweder explizit (durch Drücken einer Schaltfläche auf der Vorderseite des Geräts) oder implizit (z. B. durch Einfügen eines Dokuments in einen Feeder auf dem Gerät) auswählen.
Wenn ein Scanereignis auftritt, kann eine Anwendung die WIA_DPS_SCAN_AVAILABLE_ITEM-Eigenschaft des WIA-Scannergeräts abfragen, um die ausgewählte Eingabequelle zu identifizieren, wenn das Gerät diese Eigenschaft unterstützt. WIA_DPS_SCAN_AVAILABLE_ITEM ist eine optionale Eigenschaft des Stammelements in der WIA-Elementstruktur eines Geräts. Weitere Informationen zu dieser Eigenschaft finden Sie unter WIA_DPS_SCAN_AVAILABLE_ITEM.
Der WSD-Scanklassentreiber implementiert die WIA_DPS_SCAN_AVAILABLE_ITEM-Eigenschaft als Standardtreiberfeature, wie im vorherigen Absatz beschrieben, anstatt als benutzerdefinierte Treibererweiterung. Weitere Informationen zum WSD-Scanklassentreiber finden Sie unter WIA mit Webdiensten für Geräte. Weitere Informationen zu WDP für Scanner finden Sie unter Webdienste für Geräte Scan Service Schema.