WIA_DPS_SCAN_AVAILABLE_ITEM
La proprietà WIA_DPS_SCAN_AVAILABLE_ITEM fornisce il nome dell'origine di input per un'operazione di analisi push eseguita dall'applicazione sotto il controllo programma. Il minidriver WIA crea e gestisce questa proprietà.
Tipo di proprietà: VT_BSTR
Valori validi: WIA_PROP_NONE
Diritti di accesso: sola lettura
Commenti
In Windows 7 e versioni successive, WIA_DPS_SCAN_AVAILABLE_ITEM è una proprietà facoltativa dell'elemento radice nell'albero degli elementi WIA di un dispositivo scanner WIA. Un'applicazione può eseguire una query su questa proprietà per determinare l'origine di input (un feeder di documenti flat, un feeder di documenti automatico o una scheda di analisi del film) da cui eseguire l'analisi o la posizione di archiviazione da cui trasferire i dati.
Alcuni dispositivi scanner WIA consentono a un utente di selezionare un'origine di input per un processo di analisi dal pannello anteriore del dispositivo o di selezionare in modo implicito un'origine di input, ad esempio inserendo un documento in un feeder nel dispositivo. Quando l'utente preme il pulsante start-scan nel dispositivo, l'applicazione deve determinare l'origine di input selezionata dall'utente in modo che possa avviare un'operazione di analisi in questa origine.
Un evento di analisi notifica all'applicazione che l'utente ha avviato un'analisi, ma l'evento non specifica il nome dell'elemento WIA che rappresenta l'origine di input. Il gestore eventi dell'applicazione può eseguire query sulla proprietà WIA_DPS_SCAN_AVAILABLE_ITEM dell'elemento radice per ottenere il nome dell'elemento di origine di input.
L'elemento radice in un albero WIA ha uno o più elementi figlio (elemento flat, elemento feeder e elemento film) che rappresentano le origini di input nel dispositivo. Ognuno di questi elementi può essere un elemento padre agli elementi figlio che rappresentano parti o aree dell'origine di input. Elemento piatto che è un elemento figlio dell'elemento radice e che rappresenta l'intero letto piatto può avere figli (che sono anche elementi flat) che rappresentano le singole aree della superficie piatta. Elemento feeder figlio dell'elemento radice e che rappresenta un feeder di documenti automatico può avere elementi figlio che rappresentano gli scanner per i lati frontali e indietro delle pagine del documento che passano attraverso il feeder. Elemento film che è un elemento figlio dell'elemento radice e che rappresenta l'adattatore di analisi del film nel suo complesso può avere figli (che sono anche elementi cinematografici) che rappresentano singoli fotogrammi di film. A seconda dell'operazione di analisi richiesta dall'utente, la proprietà WIA_DPS_SCAN_AVAILABLE_ITEM può assegnare un nome a un elemento flatbed, feeder o film figlio della radice oppure può assegnare un nome figlio a uno di questi elementi. Per altre informazioni su questi elementi, vedere Categorie di elementi WIA.
Quando si verifica un evento di analisi, il driver imposta immediatamente il valore della proprietà WIA_DPS_SCAN_AVAILABLE_ITEM su un nome di elemento WIA (esattamente come segnalato dalla proprietà WIA_IPA_ITEM_NAME dell'elemento) che identifica l'origine di input da cui è disponibile il processo di analisi, se queste informazioni sono note. In caso contrario, se l'origine di input è sconosciuta, il driver imposta il valore della proprietà su una stringa vuota. Quando l'applicazione usa l'evento di analisi, lo stato dell'evento di analisi cambia da segnalato a non segnalato e il driver reimposta il valore della proprietà WIA_DPS_SCAN_AVAILABLE_ITEM in una stringa vuota.
Per altre informazioni su questa proprietà, vedere Identificazione dell'origine di input per un evento di analisi.
Requisiti
Intestazione: wiadef.h (include Wiadef.h)