Condividi tramite

Costanti delle proprietà del dispositivo scanner

  • Articolo

I dispositivi hardware Windows Image Acquisition (WIA) hanno valori di proprietà archiviati nel Registro di sistema di Windows. Per altre informazioni, vedere Costanti comuni delle proprietà del dispositivo. Le costanti di proprietà del dispositivo seguenti, con le stringhe associate, sono specifiche per gli scanner di immagini digitali.

Il prefisso "WIA_DPS_" indica una proprietà del dispositivo per i dispositivi scanner ed è la convenzione di denominazione usata in C/C++. Ai fini dello scripting, queste costanti usano il prefisso "ScannerDevice" e fanno parte del tipo enumerato WiaItemPropertyId . Il nome del membro corrispondente dell'enumerazione script viene visualizzato tra parentesi accanto al nome della costante C/C++ nell'elenco seguente.

Costante/valore Descrizione
WIA_DPS_DEVICE_ID
ScannerDeviceDeviceId
 Nota:
Questa proprietà è supportata solo in Windows Vista e versioni successive.


Contiene un identificatore univoco dell'istanza di funzione per un dispositivo scanner di servizi Web. Questo identificatore rappresenta il servizio Web nel dispositivo scanner con cui comunica il mini-driver WIA. Non devono essere effettuate ipotesi sulla forma di questo identificatore. Il mini-driver WIA crea e gestisce questa proprietà.
Le applicazioni WIA possono usare il valore di WIA_DPS_DEVICE_ID per trovare, usando l'API Individuazione funzioni, l'oggetto dell'istanza della funzione che rappresenta il dispositivo scanner dei servizi Web usato nella sessione WIA 2.0 corrente.
Tipo: VT_BSTR, Access: Sola lettura, Valori validi: WIA_PROP_NONE
WIA_DPS_DITHER_PATTERN_DATA
 Riservato, non usare.
Tipo: VT_I4, Access: Sola lettura, Valori validi: WIA_PROP_NONE
WIA_DPS_DITHER_SELECT
 Riservato, non usare.
Tipo: VT_I4, Access: Sola lettura, Valori validi: WIA_PROP_NONE
WIA_DPS_DOCUMENT_HANDLING_CAPABILITIES
ScannerDeviceDocumentHandlingCapabilities
 Contiene le funzionalità dello scanner. Il minidriver crea e gestisce questa proprietà.
Un'applicazione legge questa proprietà per determinare se lo scanner dispone di un feeder flat, di un feeder di documenti o di un duplex installato. Questa proprietà viene usata anche per definire ulteriormente le funzionalità installate.
Tipo: VT_I4, Access: Sola lettura, Valori validi: WIA_PROP_NONE
La tabella seguente descrive le costanti valide solo con Windows 7.
Flags Descrizione
AUTO_SOURCE Lo scanner dispone di un gestore di documenti automatico installato.

 

La tabella seguente descrive le costanti valide solo con Windows 7 e Windows Vista.

Flags Descrizione
ADVANCED_DUP Il dispositivo supporta la configurazione avanzata dell'analisi duplex. Usare WIA_IPS_DUPLEX_SETTINGS per passare da una configurazione duplex di base a quella avanzata.
DETECT_FILM_TPA Lo scanner può rilevare quando l'adattatore trasparente/film è pronto per l'analisi.
DETECT_STOR Lo scanner può rilevare quando sono presenti documenti nella risorsa di archiviazione interna.
FILM_TPA Lo scanner è dotato di un adattatore di scansione trasparente/pellicola.
STOR Lo scanner è dotato di un dispositivo di archiviazione delle immagini interno.

 

Nella tabella seguente vengono descritte le costanti valide con Windows XP o versioni successive.

Flags Descrizione
DETECT_FEED Lo scanner può rilevare un documento nel feeder.
DETECT_FLAT Lo scanner può rilevare un documento sul piatto piatto.
DETECT_SCAN Lo scanner può rilevare un documento nel feeder solo eseguendo l'analisi.
DUP Lo scanner ha un duplex.
NUTRIRE Lo scanner dispone di un gestore di documenti automatico installato.
PIATTO Lo scanner ha una piastra piatta.

 

Nella tabella seguente vengono descritte le costanti valide solo con Windows XP. Questi valori sono stati deprecati per Windows 7 e Windows Vista e non devono essere usati.

Flags Descrizione
DETECT_DUP Lo scanner può rilevare una richiesta di analisi duplex dall'utente.
DETECT_DUP_AVAIL Lo scanner può indicare quando è installato il duplex.
DETECT_FEED_AVAIL Lo scanner può indicare quando è installato il feeder di documenti automatico.

 
WIA_DPS_DOCUMENT_HANDLING_SELECT
ScannerDeviceDocumentHandlingSelect

Nota:
Questa proprietà non è supportata in Windows Vista e versioni successive. Usare WIA_IPS_DOCUMENT_HANDLING_SELECT.

 

Contiene l'origine e la modalità di acquisizione dello scanner corrente. Il minidriver crea e gestisce questa proprietà.

Un'applicazione legge questa proprietà per determinare l'origine di acquisizione corrente dello scanner o per scrivere questa proprietà per impostare l'origine e la modalità dello scanner. Inoltre, le applicazioni usano questa proprietà per abilitare e disabilitare la funzionalità duplex.

Tipo: VT_I4, Access: Lettura/Scrittura, Valori validi: WIA_PROP_FLAG

Nella tabella seguente sono presenti le dieci costanti valide con questa proprietà.

Flags Descrizione
ALIMENTATORE Eseguire l'analisi usando il feeder di documenti.
PIANALE Eseguire la scansione usando il piano.
DUPLEX Eseguire l'analisi usando operazioni duplex.
AUTO_ADVANCE Abilita l'alimentazione automatica del documento successivo dopo un'analisi.
FRONT_FIRST Eseguire prima la scansione della parte anteriore del documento. Questo valore è valido quando viene impostato DUPLEX.
BACK_FIRST Eseguire prima l'analisi della parte posteriore del documento. Questo valore è valido quando viene impostato DUPLEX.
FRONT_ONLY Analizza solo il front-end. Questo valore è valido quando viene impostato DUPLEX.
BACK_ONLY Analizza solo la parte posteriore. Questo valore è valido quando viene impostato DUPLEX.
NEXT_PAGE Analizzare la pagina successiva del documento.
PREFEED Abilitare la modalità pre-feed. Pre-posizione del documento successivo durante l'analisi.

 
WIA_DPS_DOCUMENT_HANDLING_STATUS
ScannerDeviceDocumentHandlingStatus

Contiene lo stato corrente del letto piatto, del feeder del documento o del duplex installato dallo scanner. Il minidriver crea e gestisce questa proprietà.

Un'applicazione legge questa proprietà per determinare se il dispositivo scanner è pronto per l'uso. Si tratta di un modo ideale per verificare se la carta si trova nel feeder prima di acquisire un'immagine.

Tipo: VT_I4, Access: Sola lettura, Valori validi: WIA_PROP_NONE

La tabella seguente contiene le costanti valide con questa proprietà. Un asterisco * indica che il flag non è supportato in Windows Vista o versioni successive. Il simbolo V indica che il flag è supportato solo in Windows Vista e versioni successive.

Flags Descrizione
FEED_READY Il letto piatto è pronto per l'uso.
FLAT_READY Lo scanner ha un documento sul piatto piatto.
DUP_READY Il duplexer è abilitato e pronto per l'uso.
FLAT_COVER_UP Il letto piatto è su.
PATH_COVER_UP Il percorso della carta è coperto e impedisce un'operazione corretta.
PAPER_JAM Un documento viene bloccato nel feeder del documento.
FILM_TPA_READYV L'adattatore di trasparenza è installato e pronto per l'uso.
STORAGE_READYV Il dispositivo di archiviazione interna è pronto.
STORAGE_FULLV L'archiviazione è completa, nessuna operazione di caricamento possibile.
MULTIPLE_FEEDV Si è verificata una condizione di feed multipla (in genere con un PAPER_JAM).
DEVICE_ATTENTIONV Si verifica un errore che richiede l'intervento dell'utente nel dispositivo.
LAMP_ERRV Lo scanner non è pronto a causa di un problema di lampada.

 
WIA_DPS_ENDORSER_CHARACTERS
ScannerDeviceEndorserCharacters

Contiene tutti i caratteri validi che un'applicazione può usare per creare stringhe di approvazione valide. Un approvatore è una stampante installata in uno scanner che stampa un messaggio di testo in ogni pagina analizzata. Il minidriver deve convalidare l'impostazione della proprietà WIA_DPS_ENDORSER_STRING rispetto al set di caratteri valido in questa proprietà. Il minidriver crea e gestisce questa proprietà.

Tipo: VT_BSTR, Access: Sola lettura, Valori validi: WIA_PROP_NONE
WIA_DPS_ENDORSER_STRING
ScannerDeviceEndorserString

Contiene una stringa che deve essere approvata (in altre parole, stampata) in ogni pagina che il minidriver analizza. Un'applicazione imposta questa proprietà usando il set di caratteri valido segnalato nella proprietà WIA_DPS_ENDORSER_CHARACTERS . Il minidriver deve approvare i documenti solo se una stringa è impostata in questa proprietà. Una stringa vuota indica che la funzionalità del servizio di approvazione è disabilitata.

Poiché è responsabilità del driver interpretare la stringa di approvazione, il driver può usare caratteri speciali in WIA_DPS_ENDORSER_STRING. Tuttavia, solo le applicazioni comprenderebbero questi caratteri.

Tipo: VT_BSTR, Accesso: Lettura/Scrittura, Valori validi: WIA_PROP_NONE

Un driver che supporta la proprietà WIA_DPS_ENDORSER_STRING deve supportare l'elenco seguente di token.

token Descrizione
$DATE$ Data nel formato AAAA/MM/DD.
$DAY$ Giorno nel formato DD.
$MONTH$ Mese dell'anno nel formato MM.
$PAGE_COUNT$ Numero di pagine trasferite.
$TIME$ Ora del giorno nel formato HH:MM:SS.
$YEAR$ Anno nel formato YYYY.

 
WIA_DPS_FILTER_SELECT

Riservato, non usare.

Tipo: VT_I4, Access: Sola lettura, Valori validi: WIA_PROP_NONE
WIA_DPS_GLOBAL_IDENTITY
ScannerDeviceGlobalIdentity

Nota:
Questa proprietà è supportata solo in Windows Vista e versioni successive.

 

Contiene l'indirizzo SOAP di un dispositivo scanner di servizi Web. Il mini-driver WIA 2.0 crea e gestisce questa proprietà.

Tipo: VT_BSTR, Access: Sola lettura, Valori validi: WIA_PROP_NONE
WIA_DPS_HORIZONTAL_BED_REGISTRATION
ScannerDeviceHorizontalBedRegistration

Nota:
Questa proprietà non è supportata con Windows Vista e versioni successive.

 

Contiene la registrazione o l'allineamento orizzontale per i documenti posizionati sul letto piatto. Il minidriver crea e gestisce questa proprietà.

Tipo: VT_I4, Access: Sola lettura, Valori validi: WIA_PROP_NONE

La tabella seguente contiene le tre costanti valide con questa proprietà.

Costante Descrizione
LEFT_JUSTIFIED La carta è lasciata giustificata.
CENTRATO La carta è centrata.
RIGHT_JUSTIFIED La carta è giusta.

 

Vedere anche

WIA_DPS_VERTICAL_BED_REGISTRATION
WIA_DPS_HORIZONTAL_BED_SIZE
ScannerDeviceHorizontalBedSize

Nota:
Questa proprietà non è supportata con Windows Vista e versioni successive. Usare WIA_IPS_MAX_HORIZONTAL_SIZE.

 

Specifica la larghezza massima, in migliaia di pollici, analizzata nell'asse orizzontale (X) dal piatto di uno scanner flat alla risoluzione corrente. Questa proprietà si applica anche ai feeder di documenti automatici che spostano fogli nel piatto di uno scanner piatto per l'analisi. Questa proprietà è obbligatoria per gli scanner con un piatto. Altri tipi di scanner implementeranno invece la proprietà WIA_DPS_HORIZONTAL_SHEET_FEED_SIZE .

Tipo: VT_I4, Access: Sola lettura, Valori validi: WIA_PROP_NONE
WIA_DPS_HORIZONTAL_SHEET_FEED_SIZE
ScannerDeviceHorizontalSheetFeedSize

Nota:
Questa proprietà non è supportata con Windows Vista e versioni successive. Usare WIA_IPS_MAX_HORIZONTAL_SIZE.

 

Specifica la larghezza massima, in migliaia di pollici, analizzata nell'asse orizzontale (X) da uno scanner di feed palmare o foglio alla risoluzione corrente. Questa proprietà si applica anche ai feeder di documenti automatici che analizzano senza spostare fogli al piatto di uno scanner flat. Questa proprietà è obbligatoria per scanner a foglio, a scorrimento e a mano.

Tipo: VT_I4, Access: Sola lettura, Valori validi: WIA_PROP_NONE
WIA_DPS_MAX_SCAN_TIME
ScannerDeviceMaxScanTime

Contiene il tempo massimo per analizzare una singola pagina con le impostazioni delle proprietà correnti, in millisecondi. Un'applicazione legge questa proprietà per stimare il tempo necessario per analizzare una pagina. Questo è utile quando si determinano le condizioni di un dispositivo che ha interrotto la risposta. Il minidriver crea e gestisce questa proprietà. Questa proprietà è necessaria per tutti gli scanner.

Tipo: VT_I4, Access: Sola lettura, Valori validi: WIA_PROP_NONE
WIA_DPS_MIN_HORIZONTAL_SHEET_FEED_SIZE
ScannerDeviceMinHorizontalSheetFeedSize

Nota:
Questa proprietà non è supportata con Windows Vista e versioni successive. Usare WIA_IPS_MIN_HORIZONTAL_SIZE.

 

Contiene le dimensioni orizzontali fisiche della pagina più piccola che il feeder del documento dello scanner può analizzare, in migliaia di pollici. Il minidriver crea e gestisce questa proprietà.

Tipo: VT_I4, Access: Sola lettura, Valori validi: WIA_PROP_NONE

Vedere anche

WIA_DPS_MIN_VERTICAL_SHEET_FEED_SIZE
WIA_DPS_MIN_VERTICAL_SHEET_FEED_SIZE
ScannerDeviceMinVerticalSheetFeedSize

Nota:
Questa proprietà non è supportata con Windows Vista e versioni successive. Usare WIA_IPS_MIN_VERTICAL_SIZE.

 

Contiene le dimensioni verticali fisiche della pagina più piccola che il feeder del documento dello scanner può analizzare, in migliaia di pollici. Il minidriver crea e gestisce questa proprietà.

Tipo: VT_I4, Access: Sola lettura, Valori validi: WIA_PROP_NONE

Vedere anche

WIA_DPS_MIN_HORIZONTAL_SHEET_FEED_SIZE
WIA_DPS_OPTICAL_XRES
ScannerDeviceOpticalXres

Nota:
Questa proprietà non è supportata da Windows Vista. Usare WIA_IPS_OPTICAL_XRES.

 

Risoluzione ottica orizzontale. Risoluzione ottica orizzontale più elevata supportata in DPI. Questa proprietà è un singolo valore. Non è un elenco di tutte le risoluzioni che possono essere generate dal dispositivo. Invece, questa è la risoluzione dell'ottica del dispositivo. Il minidriver crea e gestisce questa proprietà. Questa proprietà è necessaria per tutti gli scanner.

Tipo: VT_I4, Access: Sola lettura, Valori validi: WIA_PROP_NONE
WIA_DPS_OPTICAL_YRES
ScannerDeviceOpticalYres

Nota:
Questa proprietà non è supportata da Windows Vista. Usare WIA_IPS_OPTICAL_YRES.

 

Risoluzione ottica verticale. Risoluzione ottica verticale più elevata supportata in DPI. Questa proprietà è un singolo valore. Non è un elenco di tutte le risoluzioni generate dal dispositivo. Invece, questa è la risoluzione dell'ottica del dispositivo. Il minidriver crea e gestisce questa proprietà. Questa proprietà è necessaria per tutti gli scanner.

Tipo: VT_I4, Access: Sola lettura, Valori validi: WIA_PROP_NONE
WIA_DPS_ORIENTATION
ScannerDeviceOrientation

Contiene l'impostazione di orientamento corrente. Il minidriver crea e gestisce questa proprietà.

Un'applicazione imposta la proprietà WIA_DPS_ORIENTATION per definire l'orientamento originale di una pagina o di un'immagine da acquisire. Per informazioni su come usare WIA_DPS_ORIENTATION, vedere WIA_DPS_PAGE_SIZE

Tipo: VT_I4, Access: Lettura/Scrittura, Valori validi: WIA_PROP_LIST

La tabella seguente contiene le quattro costanti valide con questa proprietà.

Valore Defination
PAESAGGIO Rotazione antiorario a 90 gradi, rispetto all'orientamento PORTRAIT.
RITRATTO 0 gradi.
ROT180 Rotazione antiorario a 180 gradi, rispetto all'orientamento PORTRAIT.
ROT270 Rotazione antiorario a 270 gradi, rispetto all'orientamento PORTRAIT.

 

Vedere anche

WIA_IPS_ROTATION
WIA_DPS_PAD_COLOR
ScannerDevicePadColor

Colore usato per riempire un buffer richiesto quando non sono presenti dati di immagine sufficienti. Questa proprietà viene implementata per gli scanner che riempino il buffer. Questa proprietà è facoltativa per tutti gli scanner. Il minidriver crea e gestisce questa proprietà.

Tipo: VT_UI1 | VT_VECTOR, Access: Sola lettura, Valori validi: WIA_PROP_NONE

Il formato delle informazioni sul colore è RGBQUAD.
WIA_DPS_PAGE_HEIGHT
ScannerDevicePageHeight

Nota:
Questa proprietà non è supportata da Windows Vista. Usare WIA_IPS_PAGE_HEIGHT.

 

Contiene l'altezza, espressa in millesimi di pollice, della pagina attualmente selezionata. Il minidriver crea e gestisce la proprietà WIA_DPS_PAGE_HEIGHT . Un'applicazione legge questa proprietà per determinare le dimensioni fisiche della pagina analizzata. Se le impostazioni dell'extent sono diverse dalle dimensioni della pagina note, questa proprietà segnala l'altezza della pagina la cui proprietà WIA_DPS_PAGE_SIZE è impostata su WIA_PAGE_CUSTOM (valore della proprietà WIA_DPS_PAGE_SIZE ). WIA_DPS_PAGE_HEIGHT deve essere sincronizzato con WIA_IPS_XEXTENT, che segnala l'altezza, in pixel, della pagina da analizzare.

Tipo: VT_I4, Access: Sola lettura, Valori validi: WIA_PROP_NONE
WIA_DPS_PAGE_SIZE
ScannerDevicePageSize

Nota:
Questa proprietà non è supportata da Windows Vista. Usare WIA_IPS_PAGE_SIZE.

 

Contiene le dimensioni della pagina attualmente selezionata per l'analisi. Per selezionare le dimensioni della pagina da analizzare, un'applicazione imposta questa proprietà. Il minidriver crea e gestisce questa proprietà.

Tipo: VT_I4, Access: Lettura/Scrittura, Valori validi: WIA_PROP_LIST

La tabella seguente include le tre costanti valide con questa proprietà.

valore Definizione
WIA_PAGE_A4 8267 X 11692 (orientamento VERTICALE)
WIA_PAGE_CUSTOM Definito dai valori delle proprietà WIA_DPS_PAGE_HEIGHT e WIA_DPS_PAGE_WIDTH
WIA_PAGE_LETTER 8500 X 11000 (orientamento VERTICALE)

 

Il valore della proprietà WIA_IPS_ORIENTATION determina l'orientamento della pagina attualmente selezionata. Le proprietà WIA_DPS_PAGE_WIDTH e WIA_DPS_PAGE_HEIGHT segnalano le dimensioni della pagina, in millesimi di pollice. Si noti che queste proprietà devono essere in accordo con WIA_IPS_XEXTENT e WIA_IPS_YEXTENT, che contengono le dimensioni della pagina in pixel. I valori validi di tipo WIA_PROP_LIST devono dipendere dalle impostazioni valide della proprietà WIA_IPS_ORIENTATION . Se il dispositivo non è in grado di analizzare documenti orientati all'orizzontale con un'impostazione di WIA_PAGE_A4, WIA_PAGE_A4 non deve essere visualizzato nell'elenco di valori validi per la proprietà WIA_DPS_PAGE_SIZE quando WIA_IPS_ORIENTATION è impostato su LANSCAPE.

Se un'applicazione imposta WIA_DPS_PAGE_SIZE su qualsiasi valore diverso da WIA_PAGE_CUSTOM, il minidriver deve modificare i valori di WIA_DPS_PAGE_WIDTH e WIA_DPS_PAGE_HEIGHT alle dimensioni della pagina in millesimi di pollice. Deve anche modificare i valori di WIA_IPS_XEXTENT e WIA_IPS_YEXTENT alle dimensioni della pagina in pixel.

Se un'impostazione extent (WIA_IPS_XEXTENT o WIA_IPS_YEXTENT) viene modificata in un valore che non corrisponde all'impostazione di dimensioni della pagina corrente, il minidriver deve modificare il valore della proprietà WIA_DPS_PAGE_SIZE in WIA_PAGE_CUSTOM. Il minidriver deve anche modificare WIA_DPS_PAGE_WIDTH o WIA_DPS_PAGE_HEIGHT in base all'impostazione del nuovo extent.

Se WIA_IPS_ORIENTATION è impostato su LANSCAPE, le impostazioni dell'extent verranno "capovolte". Ad esempio, se un'applicazione imposta WIA_DPS_PAGE_SIZE su WIA_PAGE_A4 , il minidriver deve impostare WIA_DPS_PAGE_WIDTH su 11692 e WIA_DPS_PAGE_HEIGHT su 8267. Il minidriver deve anche impostare WIA_IPS_XEXTENT e WIA_IPS_YEXTENT di conseguenza. Si noti che se WIA_DPS_PAGE_SIZE è impostato su WIA_PAGE_CUSTOM, l'impostazione di orientamento non viene utilizzata per determinare le dimensioni extent della pagina da analizzare.

Il minidriver è responsabile di garantire che la proprietà WIA_IPS_ORIENTATION sia in accordo con l'area di selezione corrente. Se un'applicazione modifica il valore di WIA_IPS_ORIENTATION a uno non valido per le dimensioni della pagina attualmente selezionate, il minidriver deve modificare il valore di WIA_DPS_PAGE_SIZE in una dimensione di pagina supportata dal nuovo valore di orientamento.

Se un'applicazione imposta la proprietà WIA_DPS_PAGE_SIZE su WIA_PAGE_CUSTOM, l'area di selezione corrente non è interessata. Il minidriver WIA deve ottenere il layout dell'immagine corrente, a partire dalle impostazioni correnti delle proprietà WIA_IPS_XPOS e WIA_IPS_YPOS . Se l'impostazione delle dimensioni della pagina determina un'area di selezione esterna al letto dello scanner, il minidriver deve modificare automaticamente i valori della WIA_IPS_XPOS e delle proprietà WIA_IPS_YPOS alle impostazioni valide. Se le proprietà WIA_DPS_PAGE_SIZE e WIA_IPS_ORIENTATION vengono impostate contemporaneamente e non sono valide se applicate in combinazione, il minidriver deve non riuscire le impostazioni dell'applicazione restituendo un errore in IWiaMiniDrv::d rvValidateItemProperties. .

I quattro esempi seguenti illustrano diversi scenari di WIA_DPS_PAGE_SIZE .

  1. Il driver segnala le impostazioni.
  2. Un'applicazione imposta la proprietà WIA_DPS_PAGE_SIZE su WIA_PAGE_LETTER.
  3. Un'applicazione imposta la proprietà WIA_IPS_ORIENTATION su LANSCAPE.
  4. Un'applicazione modifica la proprietà WIA_IPS_XEXTENT impostando un valore inferiore.

Esempio 1: il minidriver segnala le impostazioni

Nell'esempio seguente, il minidriver imposta un'area di selezione personalizzata prima che un'applicazione imposti le proprietà WIA. In questo caso, l'area di selezione rappresenta l'intero piano.

WIA_DPS_PAGE_SIZE = WIA_PAGE_CUSTOM
WIA_DPS_PAGE_WIDTH = 11500
WIA_DPS_PAGE_HEIGHT = 14000
WIA_IPS_ORIENTATION = PORTRAIT
WIA_IPS_XPOS = 0
WIA_IPS_YPOS = 0
WIA_IPS_XEXTENT = 1150
WIA_IPS_YEXTENT = 1400
WIA_IPS_XRES = 100
WIA_IPS_YRES = 100

Esempio 2: un'applicazione imposta la proprietà WIA_DPS_PAGE_SIZEsu WIA_PAGE_LETTER

WIA_DPS_PAGE_SIZE = WIA_PAGE_LETTER
WIA_DPS_PAGE_WIDTH = 8500
WIA_DPS_PAGE_HEIGHT = 11000
WIA_IPS_ORIENTATION = PORTRAIT
WIA_IPS_XPOS = 0
WIA_IPS_YPOS = 0
WIA_IPS_XEXTENT = 850
WIA_IPS_YEXTENT = 1100
WIA_IPS_XRES = 100
WIA_IPS_YRES = 100

Esempio 3: un'applicazione imposta la proprietà WIA_IPS_ORIENTATIONsu LANSCAPE

Il letto fisico deve essere in grado di acquisire una pagina originariamente in orientamento orizzontale.

WIA_DPS_PAGE_SIZE = WIA_PAGE_LETTER
WIA_DPS_PAGE_HEIGHT = 11000
WIA_DPS_PAGE_WIDTH = 8500
WIA_IPS_ORIENTATION = LANSCAPE
WIA_IPS_XPOS = 0
WIA_IPS_YPOS = 0
WIA_IPS_XEXTENT = 1100
WIA_IPS_YEXTENT = 850
WIA_IPS_XRES = 100
WIA_IPS_YRES = 100

Esempio 4: un'applicazione modifica la proprietà WIA_IPS_XEXTENTin un valore inferiore

Nell'esempio seguente un'applicazione modifica la proprietà WIA_IPS_XEXTENT su 1000. Il minidriver deve presupporre che il nuovo valore contenuto in WIA_IPS_XEXTENT non sia più valido per la proprietà WIA_DPS_PAGE_SIZE e debba quindi modificare WIA_DPS_PAGE_SIZE in WIA_PAGE_CUSTOM. Il minidriver deve anche regolare WIA_DPS_PAGE_WIDTH.

WIA_DPS_PAGE_SIZE = WIA_PAGE_CUSTOM
WIA_DPS_PAGE_HEIGHT = 10000
WIA_DPS_PAGE_WIDTH = 8500
WIA_IPS_ORIENTATION = LANSCAPE
WIA_IPS_XPOS = 0
WIA_IPS_YPOS = 0
WIA_IPS_XEXTENT = 1000
WIA_IPS_YEXTENT = 850
WIA_IPS_XRES = 100
WIA_IPS_YRES = 100
WIA_DPS_PAGE_WIDTH
ScannerDevicePageWidth

Nota:
Questa proprietà non è supportata da Windows Vista. Usare WIA_IPS_PAGE_WIDTH.

 

Contiene la larghezza della pagina corrente selezionata, espressa in millesimi di pollice. Un'applicazione legge questa proprietà per determinare le dimensioni fisiche della pagina analizzata. Se le impostazioni dell'extent sono diverse dalle dimensioni di pagina note, questa proprietà segnala la larghezza della pagina la cui proprietà WIA_DPS_PAGE_SIZE è impostata su WIA_PAGE_CUSTOM. WIA_DPS_PAGE_WIDTH deve essere sincronizzato con il valore di WIA_IPS_XEXTENT, che segnala la larghezza, in pixel, della pagina da analizzare. Il minidriver crea e gestisce questa proprietà.

Tipo: VT_I4, Access: Sola lettura, Valori validi: WIA_PROP_NONE
WIA_DPS_PAGES
ScannerDevicePages

Nota:
Questa proprietà non è supportata da Windows Vista. Usare WIA_IPS_PAGES.

 

Contiene il numero corrente di pagine da acquisire da un feeder di documenti automatico. Il minidriver crea e gestisce questa proprietà.

Tipo: VT_I4; Accesso: lettura/scrittura; Valori validi: WIA_PROP_RANGE (zero fino al numero massimo di pagine che il feeder di documenti può contenere)

Un'applicazione legge questa proprietà per determinare la capacità della pagina del feeder di documenti. L'applicazione imposta anche questa proprietà sul numero di pagine da analizzare.

Nota:
Se la modalità duplex è abilitata (WIA_DPS_DOCUMENT_HANDLING_SELECT è impostata su FEEDER | DUPLEX ), WIA_DPS_PAGES è ancora uguale al numero di pagine da analizzare.

 

Un foglio di carta conterrà automaticamente due pagine se DUPLEX è abilitato, anche se il lato posteriore della pagina è vuoto.

Impostando WIA_DPS_PAGES su 1, uno scanner elabora uno dei lati della pagina. È consigliabile che se uno scanner non è in grado di analizzare un solo lato di una pagina in modalità duplex, il valore WIA_DPS_PAGES valido per il membro Inc della struttura WIA_PROPERTY_INFO deve essere modificato in 2. Questo valore segnala all'applicazione che deve richiedere pagine in multipli di due. Il valore zero indica che tutte le pagine attualmente caricate nel feeder di documenti devono essere analizzate.
WIA_DPS_PLATEN_COLOR
ScannerDevicePlatenColor

Specifica il colore del piatto indietro del foglio da analizzare. Questa proprietà è facoltativa per gli scanner con un piatto. Il minidriver crea e gestisce questa proprietà.

Tipo:VT_UI1 VT_VECTOR, Access: Sola lettura, Valori validi: WIA_PROP_NONE |

Il formato delle informazioni sul colore è RGBQUAD.
WIA_DPS_PREVIEW
ScannerDevicePreview

Nota:
Questa proprietà non è supportata da Windows Vista. Usare WIA_IPS_PREVIEW.

 

Indica la modalità di anteprima per un dispositivo. Un'applicazione imposta questa proprietà per posizionare il dispositivo in una modalità di anteprima.

Tipo: VT_I4, Access: Lettura/Scrittura, Valori validi: WIA_PROP_LIST

La tabella seguente contiene le due costanti valide con questa proprietà.

valore Definizione
WIA_FINAL_SCAN L'applicazione eseguirà un'analisi finale.
WIA_PREVIEW_SCAN L'applicazione eseguirà un'analisi di anteprima.

 
WIA_DPS_SCAN_AHEAD_PAGES
ScannerDeviceScanAheadPages

Contiene un valore che indica se lo scanner memorizza nella cache le pagine in un buffer dello scanner prima di inviarle all'applicazione.

Il valore zero disabilita l'analisi in anticipo e nessuna pagina verrà analizzata in anticipo. L'operazione di trasferimento dei dati normali nell'elemento di analisi con buffer recupera le pagine memorizzate nel buffer. Le proprietà WIA non possono essere modificate durante un'operazione di analisi. Questa proprietà è facoltativa.

Tipo: VT_I4, Access: Lettura/Scrittura, Valori validi: WIA_PROP_RANGE di zero al numero massimo di pagine che il feeder del documento può contenere.
WIA_DPS_SCAN_AVAILABLE_ITEM
ScannerDeviceScanAvailableItem

Nota:
Questa proprietà è supportata solo da Windows 7 e versioni successive.

 

Indica l'origine di input (letto piatto, feeder di documenti automatico o adattatore di analisi fil) da analizzare o dal percorso di archiviazione da cui trasferire i dati.

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.

Tipo: VT_I4, Access: Lettura/Scrittura, Valori validi: WIA_PROP_RANGE di zero al numero massimo di pagine che il feeder del documento può contenere.
WIA_DPS_SERVICE_ID
ScannerDeviceServiceId

Nota:
Questa proprietà è supportata solo da Windows Vista e versioni successive.

 

Contiene l'ID servizio di un dispositivo scanner di Servizi Web. Il mini-driver WIA 2.0 crea e gestisce questa proprietà.

Tipo: VT_BSTR, Access: Sola lettura, Valori validi: WIA_PROP_NONE
WIA_DPS_SHEET_FEEDER_REGISTRATION
ScannerDeviceSheetFeederRegistration

Nota:
Questa proprietà non è supportata con Windows Vista e versioni successive. Usare WIA_IPS_SHEET_FEEDER_REGISTRATION.

 

Contiene la registrazione, l'allineamento e il rilevamento dei bordi, per i documenti posizionati sul letto piatto. Il minidriver crea e gestisce questa proprietà. Questa proprietà indica come il foglio è posizionato orizzontalmente sulla testa di scansione di uno scanner portatile o con alimentazione foglio. La proprietà viene usata per stimare dove viene posizionato un documento all'interno dell'analisi.

Per gli scanner che supportano più di una testa di analisi, questa proprietà è relativa alla testa di analisi superiore. Questa proprietà è obbligatoria per gli scanner a foglio, a scorrimento e a scorrimento.

Tipo: VT_I4, Access: Sola lettura, Valori validi: WIA_PROP_NONE

La tabella seguente contiene le tre costanti valide con questa proprietà.

Costante Descrizione
LEFT_JUSTIFIED Il foglio è posizionato a sinistra rispetto alla testa di scansione.
CENTRATO Il foglio è centrato sulla testa di scansione.
RIGHT_JUSTIFIED Il foglio è posizionato a destra rispetto alla testa di scansione.

 
WIA_DPS_SHOW_PREVIEW_CONTROL
ScannerDeviceShowPreviewControl

Nota:
Questa proprietà non è supportata da Windows Vista. Usare WIA_IPS_SHOW_PREVIEW_CONTROL.

 

Indica se un elemento richiede un controllo di anteprima visualizzato all'utente. Il minidriver crea e gestisce questa proprietà.

Tipo: VT_I4, Access: Sola lettura, Valori validi: WIA_PROP_NONE

La tabella seguente contiene le due costanti valide con questa proprietà.

Costante Descrizione
WIA_SHOW_PREVIEW_CONTROL Visualizzare un controllo di anteprima all'utente, perché questo dispositivo può eseguire un'anteprima.
WIA_DONT_SHOW_PREVIEW_CONTROL Non mostrare un controllo di anteprima all'utente, perché questo dispositivo non può eseguire un'anteprima.

 
WIA_DPS_USER_NAME
ScannerDeviceUserName

Nota:
Questa proprietà è supportata solo da Windows Vista e versioni successive.

 

Usato dal servizio WIA per informare il mini-driver sul nome dell'account utente (incluso il nome di dominio di rete quando applicabile) della sessione in cui è in esecuzione l'applicazione WIA corrente.

Si tratta di una proprietà dell'elemento radice gestita dal servizio WIA.

Tipo: VT_BSTR, Access: Sola lettura, Valori validi: WIA_PROP_NONE
WIA_DPS_VERTICAL_BED_REGISTRATION
ScannerDeviceVerticalBedRegistration

Nota:
Questa proprietà non è supportata con Windows Vista e versioni successive.

 

Contiene la registrazione o l'allineamento verticale e il rilevamento dei bordi, per i documenti posizionati sul letto piatto. Il minidriver crea e gestisce questa proprietà.

Tipo: VT_I4, Access: Sola lettura, Valori validi: WIA_PROP_NONE

La tabella seguente contiene le tre costanti valide con questa proprietà.

Costante Descrizione
TOP_JUSTIFIED La carta è in alto giustificata.
CENTRATO La carta è centrata.
BOTTOM_JUSTIFIED La carta è giustificata in basso.

 

Vedere anche.

WIA_DPS_HORIZONTAL_BED_REGISTRATION
WIA_DPS_VERTICAL_BED_SIZE
ScannerDeviceVerticalBedSize

Nota:
Questa proprietà non è supportata con Windows Vista e versioni successive. Usare WIA_IPS_MAX_VERTICAL_SIZE.

 

Specifica l'altezza massima, in migliaia di pollici, analizzata nell'asse verticale (Y) dal piatto di uno scanner flat alla risoluzione corrente. Questa proprietà si applica anche ai feeder di documenti automatici, che spostano fogli al piatto di uno scanner piatto per l'analisi. Questa proprietà è obbligatoria per gli scanner con un piatto. Altri tipi di scanner implementeranno invece la proprietà WIA_DPS_VERTICAL_SHEET_FEED_SIZE .

Tipo: VT_I4, Access: Sola lettura, Valori validi: WIA_PROP_NONE
WIA_DPS_VERTICAL_SHEET_FEED_SIZE
ScannerDeviceVerticalSheetFeedSize

Nota:
Questa proprietà non è supportata con Windows Vista e versioni successive. Usare WIA_IPS_MAX_VERTICAL_SIZE.

 

Specifica l'altezza massima, in migliaia di pollici, analizzata nell'asse verticale (Y) da uno scanner di feed di fogli o palmari alla risoluzione corrente. Questa proprietà si applica anche ai feeder di documenti automatici che analizzano senza spostare fogli al piatto di uno scanner flat. Questa proprietà è obbligatoria per gli scanner con alimentazione foglio. Gli scanner a scorrimento e a mano non devono implementare questa proprietà.

Tipo: VT_I4, Access: Sola lettura, Valori validi: WIA_PROP_NONE

Requisiti

Requisito valore
Client minimo supportato
 Windows 2000 Professional, Windows XP [solo app desktop]
Server minimo supportato
 Windows Server 2003 [solo app desktop]
Intestazione
Wiadef.h