Condividi tramite


Categorie di elementi WIA

Questo argomento si applica a Windows Vista e versioni successive.

Tutti gli elementi in un albero degli elementi wia devono supportare la proprietà WIA_IPA_ITEM_CATEGORY . Questa proprietà identifica la categoria funzionale a cui appartiene un elemento. La categoria determina il set di flag di elementi WIA e le proprietà WIA associate all'elemento.

WiA definisce le categorie di elementi seguenti:

WIA_CATEGORY_ROOT
L'elemento radice nell'albero degli elementi per un dispositivo scanner WIA rappresenta il dispositivo nel suo complesso. Se il dispositivo include una funzione di scansione flat, ADF o film, gli elementi che rappresentano queste origini di input sono elementi figlio dell'elemento radice. Se il dispositivo contiene spazio di archiviazione, l'elemento della cartella più in alto nella gerarchia di archiviazione del dispositivo è figlio dell'elemento radice. Un'applicazione può accedere alle informazioni sul dispositivo, inclusi i diritti di stato, identificazione e accesso, tramite le proprietà WIA implementate nell'elemento radice. Per altre informazioni, vedere le discussioni sulle proprietà degli elementi radice in Implementazione di alberi degli elementi dello scanner flatbed, implementazione di alberi degli elementi dello scanner di feeder e implementazione di alberi degli elementi dello scanner di film.

WIA_CATEGORY_FLATBED
Un elemento piatto rappresenta un letto piatto di scansione (detto anche piatto di scansione) in un dispositivo scanner WIA. L'albero degli elementi WIA per un dispositivo con un piano di scansione deve includere un elemento flatbed che è un elemento figlio dell'elemento radice. Inoltre, se il dispositivo WIA supporta la segmentazione (ad esempio, tramite un filtro di segmentazione) o l'analisi multiregione, questo elemento flatbed deve avere elementi figlio, che sono anche elementi flatbed, per rappresentare le singole aree di analisi sul piano piano. Gli elementi figlio, se presenti, devono appartenere alla stessa categoria WIA_CATEGORY_FLATBED dell'elemento padre e devono supportare le stesse proprietà WIA (e hanno gli stessi valori delle proprietà iniziali) dell'elemento padre, ad eccezione del fatto che le posizioni e gli extent degli elementi figlio sono limitati alle aree di analisi rappresentate. Un'applicazione può usare il filtro di segmentazione del driver WIA (se disponibile) per creare aree di analisi oppure il minidriver può rilevare e creare automaticamente le aree di analisi. Un'applicazione può accedere alla funzione di scansione flatbed del dispositivo tramite le proprietà WIA implementate sull'elemento piatto (o gli elementi). Per altre informazioni, vedere Implementazione di alberi degli elementi dello scanner flat.

WIA_CATEGORY_FEEDER
Un elemento del feeder rappresenta un feeder di documenti automatico (ADF) in un dispositivo scanner WIA. Questa categoria di elementi può anche rappresentare un feeder che non è completamente automatico e che richiede assistenza manuale dall'utente, ma, in questo caso, il minidriver WIA è responsabile della verifica che la pagina del documento successiva sia avanzata tramite il feeder prima di eseguire l'analisi della pagina. Un dispositivo con ADF deve includere un elemento del feeder nell'albero degli elementi WIA. Un elemento feeder è un elemento figlio dell'elemento radice. Un'applicazione può accedere alla funzione di analisi ADF del dispositivo tramite le proprietà WIA implementate nell'elemento del feeder. Per altre informazioni, vedere Implementazione degli alberi degli elementi dello scanner di feeder.

Se ADF può eseguire l'analisi duplex (ovvero analizzare entrambi i lati di una pagina del documento) e supporta impostazioni di controllo diverse per l'analisi dei lati anteriori e posteriore delle pagine del documento, il minidriver WIA deve implementare un elemento anteriore del feeder e un elemento indietro del feeder come elementi figlio dell'elemento del feeder. Un'applicazione può accedere alle funzioni di analisi front-end e back di Azure Data Factory tramite le proprietà WIA implementate nell'elemento anteriore del feeder e nell'elemento nascosto del feeder. Per altre informazioni su questi due elementi, vedere le descrizioni delle categorie seguenti.

WIA_CATEGORY_FEEDER_FRONT
Un elemento iniziale del feeder rappresenta le impostazioni di ADF per l'analisi del lato anteriore delle pagine di un documento. Questo elemento deve essere implementato dal minidriver WIA per un dispositivo scanner che dispone di un ADF in grado di eseguire l'analisi duplex e che supporta impostazioni di controllo diverse per l'analisi dei lati anteriori e posteriore delle pagine documento. Un dispositivo con ADF che usa sempre le stesse impostazioni per entrambi i lati delle pagine del documento non richiede questo elemento. Un elemento iniziale del feeder è un elemento figlio di un elemento del feeder. Un'applicazione può accedere alla funzione di analisi anteriore di Azure Data Factory tramite le proprietà WIA implementate nell'elemento anteriore del feeder. Per altre informazioni, vedere Implementazione degli alberi degli elementi dello scanner di feeder.

WIA_CATEGORY_FEEDER_BACK
Un elemento back del feeder rappresenta le impostazioni di ADF per l'analisi del lato posteriore delle pagine di un documento. Questo elemento deve essere implementato dal minidriver WIA per un dispositivo scanner che dispone di un ADF in grado di eseguire l'analisi duplex e che supporta impostazioni di controllo diverse per l'analisi dei lati anteriori e posteriore delle pagine documento. Un dispositivo con ADF che usa sempre le stesse impostazioni per entrambi i lati delle pagine del documento non richiede questo elemento. Un elemento back del feeder è un elemento figlio di un elemento del feeder. Un'applicazione può accedere alla funzione di analisi back di Azure Data Factory tramite le proprietà WIA implementate nell'elemento back del feeder. Per altre informazioni, vedere Implementazione degli alberi degli elementi dello scanner di feeder.

WIA_CATEGORY_FILM
Un elemento film rappresenta una funzione di scansione film su un dispositivo scanner WIA. Un dispositivo che è uno scanner di film dedicato o che è uno scanner a piano dotato di un adattatore di trasparenza (TPA), deve includere uno o più elementi di film nell'albero degli elementi WIA. Un elemento film è un elemento figlio dell'elemento radice o di un altro elemento film. Un elemento film figlio dell'elemento radice rappresenta l'intera superficie di scansione e questo elemento film potrebbe avere elementi figlio che rappresentano le aree della superficie di scansione che corrispondono a singoli fotogrammi di film. Un'applicazione può accedere alla funzione di scansione dei film del dispositivo tramite le proprietà WIA implementate sull'elemento film (o gli elementi). Per altre informazioni, vedere Implementazione di alberi degli elementi dello scanner di film.

WIA_CATEGORY_FOLDER
Un elemento della cartella rappresenta una cartella che si trova nella risorsa di archiviazione interna del dispositivo scanner WIA. Un elemento della cartella è un elemento figlio dell'elemento radice o di un altro elemento della cartella. Se un elemento della cartella include elementi figlio, gli elementi figlio sono una combinazione di elementi di file e elementi di cartella completati. L'elemento della cartella più in alto in un albero di elementi è un elemento figlio dell'elemento radice. Un'applicazione può accedere al contenuto della cartella e alle informazioni sulla cartella tramite le proprietà WIA implementate nell'elemento della cartella. Per altre informazioni, vedere Archiviazione dello scanner WIA.

WIA_CATEGORY_FINISHED_FILE
Un elemento di file completato rappresenta un file completato archiviato in una cartella in un dispositivo scanner WIA. Un file completato è un file il cui contenuto non verrà modificato. Questa definizione esclude i file il cui contenuto può cambiare dinamicamente, ad esempio, man mano che lo scanner acquisisce ed elabora i dati delle immagini. Un elemento di file completato è un elemento figlio di un elemento della cartella. Un'applicazione può accedere a un file completato e a informazioni sul file tramite le proprietà WIA implementate nell'elemento del file completato. Per altre informazioni, vedere Archiviazione dello scanner WIA.

WIA_CATEGORY_AUTO
In Windows 7 e versioni successive, un elemento automatico rappresenta le impostazioni di configurazione automatica per un dispositivo scanner WIA che supporta l'analisi configurata automaticamente. Questo tipo di dispositivo può configurare le proprie impostazioni di analisi invece di richiedere la configurazione delle impostazioni da parte di un'applicazione WIA in esecuzione in un computer desktop. Ad esempio, se il dispositivo consente all'utente di avviare un'operazione di analisi dal dispositivo (anziché dall'interfaccia utente dell'applicazione) e di selezionare l'origine di input per l'operazione dal dispositivo, l'applicazione può usare l'elemento automatico per l'offload, al dispositivo, l'attività di configurazione dell'origine di input selezionata. Un elemento automatico è un elemento figlio dell'elemento radice. Un albero WIA che contiene un elemento automatico deve contenere anche uno o più degli elementi seguenti: elemento flat, elemento feeder o elemento film. Un'applicazione può accedere alla funzione di analisi configurata automaticamente di un dispositivo tramite le proprietà WIA implementate nell'elemento radice e nell'elemento automatico. Per altre informazioni, vedere Proprietà WIA supportate da un elemento automatico.

Ogni categoria di elementi WIA include un set di flag di elemento WIA necessari e proprietà WIA che un elemento nella categoria deve supportare e, inoltre, un set di flag e proprietà che l'elemento può supportare come opzioni. Per un riepilogo dei flag e delle proprietà associati alle varie categorie di elementi, vedere WIA_IPA_ITEM_CATEGORY. Per un elenco completo dei flag di elementi WIA, vedi WIA_IPA_ITEM_FLAGS.