Identificazione dell'origine di input per un evento di analisi
Un'operazione di analisi push è un'operazione di analisi che l'utente avvia da un dispositivo scanner WIA anziché dall'interfaccia utente di un'applicazione WIA in esecuzione in un computer desktop. Quando l'utente preme il pulsante di avvio dell'analisi nel dispositivo, l'applicazione riceve un evento di analisi per notificare che l'utente ha richiesto un'operazione di analisi. In risposta a questo evento, l'applicazione può eseguire l'operazione di analisi push in uno dei due modi seguenti:
Se il dispositivo supporta l'analisi configurata automaticamente, l'applicazione può richiedere un trasferimento dei dati dall'elemento automatico per acquisire un'immagine dall'origine di input attualmente selezionata (flatbed, automatic document feeder o adattatore per la scansione film). In risposta, il dispositivo configura automaticamente le impostazioni di analisi (escluse le poche proprietà che possono essere configurate solo dall'applicazione, descritte in Proprietà WIA supportate da un elemento automatico) e quindi acquisisce l'immagine.
L'applicazione può eseguire l'operazione di analisi sotto il controllo diretto del programma. Innanzitutto, l'applicazione configura le proprietà dell'elemento WIA (elemento flat, elemento feeder o elemento film) che rappresenta l'origine di input attualmente selezionata. Successivamente, l'applicazione acquisisce un'immagine richiedendo un trasferimento dei dati da questo elemento.
Per altre informazioni sugli elementi WIA, vedere Categorie di elementi WIA.
Quando si verifica un evento di analisi, l'applicazione riceve una notifica che include un identificatore di evento WIA (un valore GUID) per specificare la natura dell'evento. Il minidriver WIA può assegnare un GUID dell'identificatore di evento WIA personalizzato a un evento oppure il minidriver può usare una delle costanti GUID WIA_EVENT_SCAN_XXX definite nel file di intestazione Wiadef.h. Per altre informazioni su queste costanti, vedere Identificatori di evento WIA.
Sebbene l'identificatore dell'evento WIA per un evento di analisi fornisca informazioni sull'evento, non identifica l'origine di input da utilizzare per l'operazione di analisi. Per l'analisi configurata automaticamente, l'applicazione non necessita di queste informazioni. Tuttavia, per eseguire un'analisi sotto il controllo diretto del programma, l'applicazione deve conoscere l'origine di input da usare. L'applicazione deve avere un modo per ottenere queste informazioni dal dispositivo se il dispositivo ha più di un'origine di input e l'utente può selezionare l'origine di input dal dispositivo anziché dall'interfaccia utente dell'applicazione. Quando si seleziona un'origine di input dal dispositivo, l'utente può selezionare l'origine in modo esplicito (premendo un pulsante sul pannello anteriore del dispositivo) o in modo implicito (ad esempio, inserendo un documento in un feeder nel dispositivo).
Quando si verifica un evento di analisi, un'applicazione può eseguire una query sulla proprietà WIA_DPS_SCAN_AVAILABLE_ITEM del dispositivo scanner WIA per identificare l'origine di input selezionata, se il dispositivo supporta questa proprietà. WIA_DPS_SCAN_AVAILABLE_ITEM è una proprietà facoltativa dell'elemento radice nell'albero degli elementi WIA di un dispositivo. Per altre informazioni su questa proprietà, vedere WIA_DPS_SCAN_AVAILABLE_ITEM.
Il driver della classe di analisi WSD implementa la proprietà WIA_DPS_SCAN_AVAILABLE_ITEM come funzionalità di driver standard, come descritto nel paragrafo precedente, anziché come estensione del driver personalizzata. Per altre informazioni sul driver di classe di analisi WSD, vedere WiA with Web Services for Devices (WiA with Web Services for Devices). Per altre informazioni su WDP per gli scanner, vedere Web Services for Devices Scan Service Schema.For more information about WDP for scanners, see Web Services for Devices Scan Service Schema.