Share via

Costanti delle proprietà dell'elemento WIA scanner

  • Articolo

Le costanti seguenti specificano il set valido di proprietà degli elementi dello scanner Windows Image Acquisition (WIA).

Il prefisso "WIA_IPS_" indica una proprietà item per i dispositivi scanner ed è la convenzione di denominazione usata in C/C++. Ai fini dello scripting, queste costanti usano il prefisso "ScannerPicture" 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_IPS_AUTO_DESKEW
ScannerPictureAutoDeskew
 Nota:
Questa proprietà è supportata solo da Windows Vista e versioni successive.


Attiva o disattiva la scrivania automatica.
Facoltativo solo per WIA_CATEGORY_FEEDER.
Tipo: VT_I4, accesso: lettura/scrittura, valori validi: WIA_PROP_LIST
Nella tabella seguente sono presenti le costanti valide con questa proprietà.

Costante Descrizione
WIA_AUTO_DESKEW_ON Attivare il deskew automatico.
WIA_AUTO_DESKEW_OFF Disattivare la scrivania automatica.

 
WIA_IPS_BRIGHTNESS
ScannerPictureBrightness

Valori di luminosità dell'immagine disponibili all'interno dello scanner.

Contiene l'impostazione di luminosità hardware corrente per il dispositivo. Un'applicazione imposta questa proprietà sul valore di luminosità dell'hardware. Il minidriver crea e gestisce questa proprietà.

I valori devono essere mappati in un intervallo compreso tra -1000 e 1000, dove 1000 corrisponde alla luminosità massima, 0 corrisponde alla luminosità normale e -1000 corrisponde alla luminosità minima.

Obbligatorio per tutti gli elementi nelle categorie: WIA_CATEGORY_FLATBED, WIA_CATEGORY_FEEDER, WIA_CATEGORY_FEEDER_FRONT, WIA_CATEGORY_FEEDER_BACK e WIA_CATEGORY_FILM. Facoltativo, ma consigliato, per WIA_CATEGORY_FINISHED_FILE elementi che supportano le anteprime.

Tipo: VT_I4, accesso: lettura/scrittura, valori validi: WIA_PROP_RANGE
WIA_IPS_CONTRAST
ScannerPictureContrast

Contiene l'impostazione corrente del contrasto hardware per un dispositivo. Un'applicazione imposta questa proprietà sul valore di contrasto dell'hardware. Il minidriver crea e gestisce questa proprietà.

I valori devono essere mappati in un intervallo compreso tra -1000 e 1000, dove -1000 corrisponde al contrasto minimo, 0 corrisponde al contrasto normale e 1000 corrisponde al contrasto massimo.

Obbligatorio per tutti gli elementi nelle categorie: WIA_CATEGORY_FLATBED, WIA_CATEGORY_FEEDER, WIA_CATEGORY_FEEDER_FRONT, WIA_CATEGORY_FEEDER_BACK e WIA_CATEGORY_FILM. Facoltativo, ma consigliato, per WIA_CATEGORY_FINISHED_FILE elementi che supportano le anteprime.

Tipo: VT_I4, accesso: lettura/scrittura, valori validi: WIA_PROP_RANGE
WIA_IPS_CUR_INTENT
ScannerPictureCurIntent

Contiene le impostazioni correnti della finalità. Il minidriver crea e gestisce questa proprietà.

Obbligatorio per tutti gli elementi abilitati per l'acquisizione; ovvero gli elementi nelle categorie: WIA_CATEGORY_FLATBED, WIA_CATEGORY_FEEDER, WIA_CATEGORY_FEEDER_FRONT, WIA_CATEGORY_FEEDER_BACK e WIA_CATEGORY_FILM. Non è supportato per gli elementi WIA_CATEGORY_FINISHED_FILE o WIA_CATEGORY_FOLDER.

Tipo: accesso VT_I4 : lettura/scrittura, valori validi: WIA_PROP_FLAGS

Il driver usa queste proprietà per impostare le proprietà degli elementi in base all'uso previsto dell'immagine da parte di un'applicazione. Ciò può includere, ad esempio, la qualità massima, le dimensioni minime e così via.

Il driver sceglie la profondità di bit, in punti per pollice e altre impostazioni che determinano sono appropriate per la finalità selezionata. Spetta all'applicazione leggere le impostazioni correnti per determinare quali proprietà sono state modificate. Un'applicazione imposta questa proprietà per impostare automaticamente le proprietà WIA per finalità di acquisizione specifiche. Questa proprietà è necessaria per tutti gli scanner.

Un'applicazione imposta questa proprietà per impostare automaticamente le proprietà WIA per finalità di acquisizione specifiche

Nota:
I flag possono essere combinati con un operatore OR bit per bit, ma un'immagine non può essere sia in scala di grigi che in un colore.

 

Questa proprietà è necessaria per tutti gli scanner.

La tabella seguente contiene i flag di tipo immagine e le relative definizioni. Questi flag vengono usati per impostare il tipo di immagine desiderato: colore, scala di grigi e così via.

Flag del tipo di immagine desiderato Descrizione
WIA_INTENT_NONE Valore predefinito. Non viene specificata alcuna finalità.
WIA_INTENT_IMAGE_TYPE_COLOR L'applicazione intende preparare il dispositivo per una scansione dei colori.
WIA_INTENT_IMAGE_TYPE_GRAYSCALE L'applicazione intende preparare il dispositivo per un'analisi in scala di grigi.
WIA_INTENT_IMAGE_TYPE_TEXT L'applicazione intende preparare il dispositivo per l'analisi del testo.
WIA_INTENT_IMAGE_TYPE_MASK Maschera per tutti i flag di tipo immagine.

 

La tabella seguente contiene i flag di qualità e dimensione e le relative definizioni. Questi flag vengono usati per impostare il livello di qualità desiderato.

Flag di qualità/dimensioni dell'immagine desiderati Descrizione
WIA_INTENT_MINIMIZE_SIZE L'applicazione intende preparare il dispositivo per l'analisi di un'immagine che genera un'analisi di piccole dimensioni.
WIA_INTENT_MAXIMIZE_QUALITY L'applicazione intende preparare il dispositivo per l'analisi di un'immagine di alta qualità.
WIA_INTENT_SIZE_MASK Questo flag è una maschera per tutti i flag di dimensioni/qualità.
WIA_INTENT_BEST_PREVIEW L'applicazione intende preparare il dispositivo per l'analisi di un'anteprima.

 
WIA_IPS_DESKEW_X
ScannerPictureDeskewX

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

 

Contiene il numero di pixel nella direzione x da WIA_IPS_XPOS alla coordinata x dell'angolo superiore dell'immagine da scrivania. Di conseguenza, descrive, in combinazione con WIA_IPS_DESKEW_Y, in cui i due angoli superiori dell'immagine asimmetrica si trovano all'interno del rettangolo di delimitazione definito da WIA_IPS_XPOS, WIA_IPS_YPOS, WIA_IPS_XEXTENT e WIA_IPS_YEXTENT. la sua proprietà è implementata dal conducente dello scanner se supporta deskewing.

I valori validi per WIA_IPS_DESKEW_X devono essere compresi tra 0 e (WIA_IPS_XEXTENT - 1). Il valore 0 indica che non deve essere eseguita alcuna scrivania.

Questa proprietà è facoltativa per gli elementi delle categorie WIA_CATEGORY_FLATBED, WIA_CATEGORY_FEEDER e WIA_CATEGORY_FILM; e non è disponibile per WIA_CATEGORY_FINISHED_FILE o WIA_CATEGORY_FOLDER elementi.

Tipo: VT_I4, accesso: lettura/scrittura, valori validi: WIA_PROP_RANGE
WIA_IPS_DESKEW_Y
ScannerPictureDeskewY

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

 

Contiene il numero di pixel nella direzione y da WIA_IPS_YPOS alla coordinata y dell'angolo più a sinistra dell'immagine da scrivania. Di conseguenza, descrive, in combinazione con WIA_IPS_DESKEW_X, in cui i due angoli superiori dell'immagine asimmetrica si trovano all'interno del rettangolo di delimitazione definito da WIA_IPS_XPOS, WIA_IPS_YPOS, WIA_IPS_XEXTENT e WIA_IPS_YEXTENT. Questa proprietà viene implementata dal driver dello scanner se supporta deskewing.

I valori validi per WIA_IPS_DESKEW_Y devono essere compresi tra 0 e (WIA_IPS_YEXTENT - 1). Il valore 0 indica che non deve essere eseguita alcuna scrivania.

Questa proprietà è facoltativa per gli elementi delle categorie WIA_CATEGORY_FLATBED, WIA_CATEGORY_FEEDER e WIA_CATEGORY_FILM; e non è disponibile per WIA_CATEGORY_FINISHED_FILE o WIA_CATEGORY_FOLDER elementi.

Tipo: VT_I4, accesso: lettura/scrittura, valori validi: WIA_PROP_RANGE
WIA_IPS_DOCUMENT_HANDLING_SELECT
ScannerPictureDocumentHandlingSelect

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

 

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 costanti valide con questa proprietà.

Flags Descrizione
DUPLEX Eseguire l'analisi usando operazioni duplex. Analizzare entrambi i lati del documento usando le impostazioni comuni configurate per l'elemento del feeder (WIA_CATEGORY_FEEDER). Duplex e ADVANCE_DUPLEX non possono essere impostati entrambi.
ADVANCED_DUPLEX Eseguire l'analisi usando singole impostazioni configurate per ogni elemento del feeder figlio (WIA_CATEGORY_FEEDER_FRONT e WIA_CATEGORY_FEEDER_BACK). Duplex e ADVANCE_DUPLEX non possono essere impostati entrambi.
FRONT_FIRST Eseguire prima la scansione della parte anteriore del documento. Questo valore è valido quando è impostato DUPLEX o ADVANCED_DUPLEX.
BACK_FIRST Analizzare prima la parte posteriore del documento. Questo valore è valido quando è impostato DUPLEX o ADVANCED_DUPLEX.
FRONT_ONLY Analizza solo la parte anteriore.
BACK_ONLY Analizza solo il retro. Questo valore è valido quando è impostato DUPLEX o ADVANCED_DUPLEX.

 
WIA_IPS_FILM_NODE_NAME
ScannerPictureFilmNodeName

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

 

Abilita la specifica di un particolare allegato di scansione film quando è presente più di uno.

Questa proprietà è necessaria per gli elementi WIA_CATEGORY_FILM quando sono presenti più elementi di scansione film. Se il dispositivo supporta un solo elemento film dello scanner radice, questa proprietà è facoltativa.

Tipo: VT_BSTR, Accesso: Sola lettura, Valori validi: WIA_PROP_NONE

Valori consentiti: il valore BSTR deve essere sotto forma di @ResourceBinary,-<ResourceID> per consentire la localizzazione perché questa stringa verrebbe esposta all'utente tramite l'interfaccia utente di analisi dei film.
WIA_IPS_FILM_SCAN_MODE
ScannerPictureFilmScanMode

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

 

Abilita la configurazione dell'analisi del film corrente.

Questa proprietà è necessaria per l'elemento WIA_CATEGORY_FILM.

Tipo: VT_I4, accesso: lettura/scrittura, valori validi: WIA_PROP_LIST

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

Costante Descrizione
WIA_FILM_COLOR_SLIDE Cerca una diapositiva a colori.
WIA_FILM_COLOR_NEGATIVE Cerca un colore negativo.
WIA_FILM_BW_NEGATIVE Cerca un negativo nero e bianco.

 
WIA_IPS_INVERT
ScannerPictureInvert

Riservato per uso futuro e non implementato in questo momento.

Tipo: VT_I4, Accesso: Sola lettura, Valori validi: WIA_PROP_NONE
WIA_IPA_ITEMS_STORED
ScannerPictureInvert

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

 

Specifica il numero di elementi archiviati nell'elemento WIA_CATEGORY_FOLDER.

Tipo: VT_I4, Accesso: Sola lettura, Valori validi: WIA_PROP_NONE
WIA_IPS_LAMP
ScannerPictureLamp

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

 

Attiva o disattiva la lampada dello scanner.

Facoltativo per gli elementi WIA_CATEGORY_FLATBED, WIA_CATEGORY_FEEDER e WIA_CATEGORY_FILM e consigliati per WIA_CATEGORY_FILM.

Tipo: VT_I4, accesso: lettura/scrittura, valori validi: WIA_PROP_LIST

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

Costante Descrizione
WIA_LAMP_ON Accendere la lampada.
WIA_LAMP_OFF Spegni la lampada.

 
WIA_IPS_LAMP_AUTO_OFF
ScannerPictureLampAutoOff

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

 

Imposta il tempo massimo per mantenere attiva la lampada quando lo scanner non viene utilizzato.

Facoltativo per gli elementi WIA_CATEGORY_FLATBED, WIA_CATEGORY_FEEDER e WIA_CATEGORY_FILM e consigliati per WIA_CATEGORY_FILM.

Tipo: VT_UI4, accesso: lettura/scrittura, valori validi: 0 - 0xFFF secondi
WIA_IPS_MAX_HORIZONTAL_SIZE
ScannerPictureMaxHorizontalSize

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

 

Specifica la larghezza massima, espressa in millesimi di pollice, analizzata nell'asse orizzontale (X) alla risoluzione corrente. Questo può essere la larghezza del feeder foglio o il letto di scansione, in base al tipo di elemento.

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

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

 

Specifica l'altezza massima, in migliaia di pollici, analizzata nell'asse verticale (Y) alla risoluzione corrente. Questo può essere l'altezza del feeder foglio o del letto di scansione, in base al tipo di elemento.

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

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

 

Specifica la larghezza minima, in migliaia di pollici, analizzata nell'asse orizzontale (X) alla risoluzione corrente.

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

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

 

Specifica l'altezza minima, in migliaia di pollici, analizzata nell'asse verticale (Y) alla risoluzione corrente.

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

Riservato per l'uso futuro e non viene implementato in questo momento.

Tipo: VT_I4, accesso: sola lettura, valori validi: WIA_PROP_NONE
WIA_IPS_OPTICAL_XRES
ScannerPictureOpticalXres

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

 

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 elementi.

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

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

 

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 elementi.

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

Specifica l'orientamento corrente dei documenti da analizzare. Il minidriver crea e gestisce questa proprietà.

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

Nota:
WIA_IPS_ORIENTATION fa riferimento alla posizione del documento da analizzare sul letto dello scanner o sul feeder. Si tratta dell'orientamento del documento rispetto alla direzione dell'analisi. WIA_IPS_ROTATION fa riferimento alla rotazione applicata all'immagine dopo la scansione, subito prima che l'immagine venga trasferita all'applicazione.

 

Tipo: VT_I4, accesso: lettura/scrittura, valori validi: WIA_PROP_LIST

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

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

 
WIA_IPS_PAGE_SIZE
ScannerPicturePageSize

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

 

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

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

Per le costanti che possono essere usate con questa proprietà, vedere Costanti dimensioni pagina WIA 2.0. Si notino queste dimensioni non fisse, in particolare:

valore Definizione
WIA_PAGE_CUSTOM Definito dai valori delle proprietà WIA_IPS_PAGE_HEIGHT e WIA_IPS_PAGE_WIDTH .
WIA_PAGE_AUTO Le dimensioni della pagina vengono determinate automaticamente dal dispositivo.
WIA_PAGE_CUSTOM_BASE Dimensioni di pagina personalizzate le cui dimensioni sono già note all'applicazione e al driver di dispositivo.

 

Il valore della proprietà WIA_IPS_ORIENTATION determina l'orientamento della pagina attualmente selezionata. Le proprietà WIA_IPS_PAGE_WIDTH e WIA_IPS_PAGE_HEIGHT segnalano le dimensioni della pagina, in migliaia di pollici. Queste proprietà devono essere in accordo con WIA_IPS_XEXTENT e WIA_IPS_YEXTENT, che contengono le dimensioni della pagina in pixel.

Nota:
I valori validi di tipo WIA_PROP_LIST dipendono dalle impostazioni valide della proprietà WIA_IPS_ORIENTATION . Se, ad esempio, il dispositivo non può analizzare i documenti orientati verso l'ambiente con un'impostazione WIA_PAGE_A4, WIA_PAGE_A4 non è un valore valido per la proprietà WIA_IPS_PAGE_SIZE quando WIA_IPS_ORIENTATION è impostato su LANDSCAPE.

 

Se un'applicazione imposta WIA_IPS_PAGE_SIZE su qualsiasi valore diverso dai tre nella tabella precedente, il minidriver deve modificare i valori di WIA_IPS_PAGE_WIDTH e WIA_IPS_PAGE_HEIGHT alle dimensioni della pagina in migliaia di pollici. Deve anche modificare i valori di WIA_IPS_XEXTENT e WIA_IPS_YEXTENT alle dimensioni della pagina in pixel.

Se un'impostazione di estensione (WIA_IPS_XEXTENT o WIA_IPS_YEXTENT) viene modificata in un valore che non corrisponde all'impostazione delle dimensioni della pagina corrente, il minidriver deve modificare il valore della proprietà WIA_IPS_PAGE_SIZE in WIA_PAGE_CUSTOM. Il minidriver deve anche modificare WIA_IPS_PAGE_WIDTH o WIA_IPS_PAGE_HEIGHT in conformità con l'impostazione del nuovo extent.

Se WIA_IPS_ORIENTATION è impostato su LANDSCAPE, le impostazioni di estensione verranno scambiate rispetto ai valori normali. Ad esempio, se un'applicazione imposta WIA_IPS_PAGE_SIZE su WIA_PAGE_A4 , il minidriver imposta WIA_IPS_PAGE_WIDTH su 11692 e WIA_IPS_PAGE_HEIGHT su 8267. Il minidriver deve anche regolare WIA_IPS_XEXTENT e WIA_IPS_YEXTENT di conseguenza.

Nota:
Se WIA_IPS_PAGE_SIZE è impostato su WIA_PAGE_CUSTOM, l'impostazione dell'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_IPS_PAGE_SIZE in una dimensione di pagina supportata dal nuovo valore di orientamento.

Se un'applicazione imposta la proprietà WIA_IPS_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 delle proprietà WIA_IPS_XPOS e WIA_IPS_YPOS alle impostazioni valide. Se le proprietà WIA_IPS_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_IPS_PAGE_SIZE .

  1. Il driver segnala le impostazioni.
  2. Un'applicazione imposta la proprietà WIA_IPS_PAGE_SIZE su WIA_PAGE_LETTER.
  3. Un'applicazione imposta la proprietà WIA_IPS_ORIENTATION su LANDSCAPE.
  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_IPS_PAGE_SIZE = WIA_PAGE_CUSTOM
WIA_IPS_PAGE_WIDTH = 11500
WIA_IPS_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_IPS_PAGE_SIZEsu WIA_PAGE_LETTER

WIA_IPS_PAGE_SIZE = WIA_PAGE_LETTER
WIA_IPS_PAGE_WIDTH = 8500
WIA_IPS_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 LANDSCAPE

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

WIA_IPS_PAGE_SIZE = WIA_PAGE_LETTER
WIA_IPS_PAGE_HEIGHT = 11000
WIA_IPS_PAGE_WIDTH = 8500
WIA_IPS_ORIENTATION = LANDSCAPE
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_IPS_PAGE_SIZE e debba quindi modificare WIA_IPS_PAGE_SIZE in WIA_PAGE_CUSTOM. Il minidriver deve anche regolare WIA_IPS_PAGE_WIDTH.

WIA_IPS_PAGE_SIZE = WIA_PAGE_CUSTOM
WIA_IPS_PAGE_HEIGHT = 10000
WIA_IPS_PAGE_WIDTH = 8500
WIA_IPS_ORIENTATION = LANDSCAPE
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_IPS_PAGE_HEIGHT
ScannerPicturePageHeight

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

 

Contiene l'altezza, espressa in millesimi di pollice, della pagina attualmente selezionata. Il minidriver crea e gestisce la proprietà WIA_IPS_PAGE_HEIGHT . 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 l'altezza della pagina la cui proprietà WIA_IPS_PAGE_SIZE è impostata su WIA_PAGE_CUSTOM (valore della proprietà WIA_IPS_PAGE_SIZE ). WIA_IPS_PAGE_HEIGHT deve essere sincronizzato con WIA_IPS_XEXTENT, che segnala l'altezza, in pixel, della pagina da analizzare.

Questa proprietà è necessaria per WIA_CATEGORY_FEEDER elementi.

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

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

 

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_IPS_PAGE_SIZE è impostata su WIA_PAGE_CUSTOM. WIA_IPS_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à.

Questa proprietà è necessaria per WIA_CATEGORY_FEEDER elementi.

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

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

 

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 Questo valore è zero fino al numero massimo di pagine che lo scanner può analizzare. Il valore è ALL_PAGES (= 0) se lo scanner può analizzare continuamente.

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_IPS_DOCUMENT_HANDLING_SELECT è impostata su FEEDER | DUPLEX | ADVANCED_DUPLEX), WIA_IPS_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.

L'impostazione di WIA_IPS_PAGES su 1 determina l'elaborazione di un lato della pagina da parte di uno scanner. È consigliabile che, se uno scanner non è in grado di analizzare un solo lato di una pagina in modalità duplex, si modifica il valore WIA_IPS_PAGES per il membro Inc del membro Range della struttura WIA_PROPERTY_INFO su 2. Questo valore segnala all'applicazione che deve richiedere pagine in multipli di due. Un valore di ALL_PAGES (= 0) indica che tutte le pagine attualmente caricate nel feeder di documenti devono essere analizzate.
WIA_IPS_PHOTOMETRIC_INTERP
ScannerPicturePhotometricInterp

Contiene l'impostazione corrente per i pixel bianchi e neri. Il minidriver crea e gestisce questa proprietà.

Un'applicazione legge questo valore per determinare il valore di WHITE o BLACK (a seconda delle operazioni eseguite dall'applicazione).

Obbligatorio per tutte le acquisizioni abilitate o archiviate; ovvero gli elementi nelle categorie: WIA_CATEGORY_FLATBED, WIA_CATEGORY_FEEDER, WIA_CATEGORY_FEEDER_FRONT, WIA_CATEGORY_FEEDER_BACK, WIA_CATEGORY_FINISHED_FILE e WIA_CATEGORY_FILM. Non è supportato per gli elementi WIA_CATEGORY_FOLDER.

Tipo: VT_I4; Accesso: lettura/scrittura; Valori validi: WIA_PROP_LIST. Se il dispositivo può essere impostato su un solo valore, creare un tipo di WIA_PROP_LIST e inserirlo nel valore valido.

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

valore Definizione
WIA_PHOTO_WHITE_0 WHITE è 0 e BLACK è 1.
WIA_PHOTO_WHITE_1 WHITE è 1 e BLACK è 0.

 
WIA_IPS_PREVIEW
ScannerPicturePreview

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

 

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

Questa proprietà è obbligatoria per gli elementi WIA_CATEGORY_FLATBED e WIA_CATEGORY_FILM, facoltativa per l'elemento WIA_CATEGORY_FEEDER.

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

Nella tabella seguente sono presenti le 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_IPS_PREVIEW_TYPE
ScannerPicturePreviewType

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

 

Specifica se l'immagine di anteprima esistente può essere aggiornata durante un'anteprima dell'immagine (in risposta a una modifica nelle proprietà WIA_IPA_DATATYPE o WIA_IPA_DEPTH).

Questa proprietà è facoltativa per tutti gli elementi abilitati per l'acquisizione che supportano le analisi di anteprima; ovvero, WIA_IPS_PREVIEW è supportato con WIA_PREVIEW_SCAN. Sono inclusi elementi di tipi WIA_CATEGORY_FLATBED, WIA_CATEGORY_FEEDER, WIA_CATEGORY_FEEDER_FRONT, WIA_CATEGORY_FEEDER_BACK e WIA_CATEGORY_FILM.

Tipo: VT_I4, accesso: sola lettura, valori validi: WIA_PROP_NONE

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

Costante Descrizione
WIA_ADVANCED_PREVIEW È possibile aggiornare l'immagine esistente.
WIA_BASIC_PREVIEW È necessario eseguire un'altra analisi di anteprima perché l'aggiornamento dell'immagine esistente non è possibile.

 
WIA_IPS_ROTATION
ScannerPictureRotation

Contiene l'impostazione di rotazione corrente, se implementata. Il minidriver crea e gestisce questa proprietà.

Un'applicazione imposta questa proprietà per informare il driver quanto (se tutto) per ruotare l'immagine prima che il driver lo restituisca all'applicazione.

Nota:
WIA_IPS_ORIENTATION fa riferimento alla posizione del documento da analizzare sul letto dello scanner o sul feeder. Si tratta dell'orientamento del documento rispetto alla direzione dell'analisi. WIA_IPS_ROTATION fa riferimento alla rotazione applicata all'immagine dopo la scansione, subito prima che l'immagine venga trasferita all'applicazione.

 

Il minidriver WIA è responsabile della rotazione dei dati dell'immagine prima di inviarli all'applicazione. L'applicazione è responsabile del controllo delle intestazioni dell'immagine per visualizzare i valori appena ruotati.

Esiste una notevole confusione sulla risoluzione dell'effetto della rotazione sull'area di selezione dell'immagine corrente ,definita dalla WIA_IPS_XPOS, WIA_IPS_YPOS, WIA_IPS_XEXTENT e WIA_IPS_YEXTENT proprietà).

L'area di selezione fa riferimento all'area selezionata nel letto dello scanner fisico da cui viene acquisita un'immagine. WIA_IPS_ROTATION non modifica l'area di selezione. Il driver applica una rotazione antiorario secondo WIA_IPS_ROTATION solo dopo che il driver ha acquisito l'area di selezione appropriata. WIA_IPS_ROTATION influisce sulle dimensioni dell'immagine di output, pertanto queste dimensioni devono essere riflesse nell'intestazione dei dati dell'immagine risultante.

Facoltativo per tutti gli elementi abilitati per l'acquisizione; ovvero gli elementi nelle categorie: WIA_CATEGORY_FLATBED, WIA_CATEGORY_FEEDER, WIA_CATEGORY_FEEDER_FRONT, WIA_CATEGORY_FEEDER_BACK e WIA_CATEGORY_FILM.

Tipo: VT_I4, accesso: lettura/scrittura, valori validi: WIA_PROP_LIST

Le costanti di rotazione seguenti sono definite.

Costante Definizione
RITRATTO Il driver non ruota l'immagine.
PAESAGGIO Il driver ruota l'immagine a 90 gradi in senso antiorario.
ROT180 Il driver ruota l'immagine a 180 gradi in senso antiorario.
ROT270 Il driver ruota l'immagine a 270 gradi in senso antiorario.

 
WIA_IPS_SEGMENTATION
ScannerPictureSegmentation

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

 

Specifica se l'applicazione deve usare il filtro di segmentazione del driver per l'analisi in più aree. WIA_IPS_SEGMENTATION deve essere implementato per WIA_CATEGORY_FLATBED e WIA_CATEGORY_FILM elementi se supportano la creazione di elementi figlio con un filtro di segmentazione o se il driver stesso crea elementi figlio per fotogrammi fissi.

Tipo: VT_I4, accesso: sola lettura, valori validi: WIA_PROP_NONE

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

valore Definizione
WIA_USE_SEGMENTATION_FILTER L'applicazione deve usare il filtro di segmentazione per l'analisi in più aree.
WIA_DONT_USE_SEGMENTATION_FILTER Il driver crea gli elementi figlio stessi per l'analisi in più aree. Questo è in genere il caso in cui lo scanner usa fotogrammi fissi per questo scopo.

 

Nota:
È possibile che un driver venga visualizzato con un filtro di segmentazione, ma abbia ancora WIA_IPS_SEGMENTATION impostato su WIA_DONT_USE_SEGMENTATION_FILTER per uno dei relativi elementi, ad esempio l'elemento WIA_CATEGORY_FILM. Questo potrebbe essere il caso se lo scanner usa fotogrammi fissi per l'analisi del film, ma non per la scansione regolare da WIA_CATEGORY_FLATBED elementi.

 
WIA_IPS_SHEET_FEEDER_REGISTRATION
ScannerPictureSheetFeederRegistration

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

 

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_IPS_SHOW_PREVIEW_CONTROL
ScannerPictureShowPreviewControl

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

 

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

Facoltativo per tutti gli elementi abilitati per il trasferimento. Questo è in genere solo elementi delle categorie WIA_ITEM_CATEGORY_FLATBED, WIA_CATEGORY_FEEDER, WIA_CATEGORY_FILM e WIA_CATEGORY_FINISHED_FILE.

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

La tabella seguente contiene le 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_IPS_SUPPORTS_CHILD_ITEM_CREATION
ScannerPictureSupportsChildItemCreation

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

 

Specifica se l'applicazione (o i filtri) può creare elementi figlio nell'elemento corrente.

Facoltativo per tutte le categorie di elementi abilitate per il trasferimento: WIA_CATEGORY_FLATBED, WIA_CATEGORY_FEEDER, WIA_CATEGORY_FILM e persino WIA_CATEGORY_FOLDER. Se l'archiviazione non supporta il caricamento di nuovi elementi, questa proprietà deve essere non supportata o supportata con il valore FALSE .

Gli elementi che supportano WIA_IPS_SEGMENTATION e WIA_USE_SEGMENTATION_FILTER devono supportare anche WIA_IPS_SUPPORTS_CHILD_ITEM_CREATION e avere impostato su TRUE.

Tipo: VT_I4, accesso: sola lettura, valori validi: TRUE e FALSE
WIA_IPS_THRESHOLD
ScannerPictureThreshold

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

 

Specifica il valore della scala di grigi che determina se un pixel verrà convertito in bianco o nero quando un'immagine viene convertita in monocromatica. I pixel al di sopra della soglia diventano bianchi. I pixel al di sotto della soglia diventano bianchi.

Questa proprietà è necessaria per gli elementi di acquisizione che supportano le analisi a 1 bpp e che hanno la proprietà WIA_IPA_DATATYPE impostata su WIA_DATA_THRESHOLD.

Tipo: VT_I4, accesso: lettura/scrittura, valori validi: WIA_PROP_RANGE
WIA_IPS_TRANSFER_CAPABILITIES
ScannerPictureTransferCapabilities

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

 

Specifica se il driver è in grado di trasferire più elementi figlio in una singola chiamata di trasferimento.

Tipo: VT_I4, Accesso: Sola lettura, Valori validi: WIA_PROP_FLAG

L'unico valore possibile per questa proprietà è WIA_TRANSFER_CHILDREN_SINGLE_SCAN. Se questo flag è impostato, il driver è in grado di trasferire più elementi figlio in una singola chiamata di trasferimento. Se il flag non è impostato, il servizio WIA scorre gli elementi figlio in modo ricorsivo e quindi trasferisce ognuno di questi elementi.
WIA_IPA_UPLOAD_ITEM_SIZE
ScannerPictureInvert

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

 

Specifica il numero di byte da caricare per l'elemento.

Tipo: VT_I4, accesso: lettura/scrittura, valori validi: WIA_PROP_NONE
WIA_IPS_WARM_UP_TIME
ScannerPictureWarmUpTime

Specifica il tempo di riscaldamento massimo, in millisecondi, necessario per il dispositivo prima di avviare l'operazione di analisi. Il minidriver crea e gestisce questa proprietà.

Un'applicazione può leggere questa proprietà per determinare il tempo massimo di riscaldamento per questo dispositivo. Può quindi presentare una finestra di dialogo "in attesa del riscaldamento del dispositivo", per informare l'utente che potrebbe verificarsi un'attesa o una pausa prima di qualsiasi evento.

Questa proprietà è necessaria per tutti gli elementi abilitati per l'acquisizione; ovvero gli elementi nelle categorie: WIA_CATEGORY_FLATBED, WIA_CATEGORY_FEEDER, WIA_CATEGORY_FEEDER_FRONT, WIA_CATEGORY_FEEDER_BACK e WIA_CATEGORY_FILM.

Tipo: VT_I4, Accesso: Sola lettura, Valori validi: WIA_PROP_NONE
WIA_IPS_XEXTENT
ScannerPictureXextent

Contiene la larghezza corrente, in pixel, dell'immagine selezionata da acquisire. Un'applicazione imposta questa proprietà per contrassegnare la larghezza di un'area di selezione da acquisire. Questa proprietà deve essere d'accordo con la proprietà WIA_IPA_PIXELS_PER_LINE . Il minidriver crea e gestisce questa proprietà.

Obbligatorio per tutti gli elementi abilitati per l'acquisizione; ovvero gli elementi nelle categorie: WIA_CATEGORY_FLATBED, WIA_CATEGORY_FEEDER, WIA_CATEGORY_FEEDER_FRONT, WIA_CATEGORY_FEEDER_BACK e WIA_CATEGORY_FILM.

Tipo: VT_I4, accesso: lettura/scrittura, valori validi: WIA_PROP_RANGE
WIA_IPS_XPOS
ScannerPictureXpos

Contiene la coordinata x, in pixel, dell'angolo superiore sinistro dell'immagine selezionata. Un'applicazione imposta questa proprietà per contrassegnare l'angolo superiore sinistro dell'area di selezione. Il minidriver crea e gestisce questa proprietà.

Obbligatorio per tutti gli elementi abilitati per l'acquisizione; ovvero gli elementi nelle categorie: WIA_CATEGORY_FLATBED, WIA_CATEGORY_FEEDER, WIA_CATEGORY_FEEDER_FRONT, WIA_CATEGORY_FEEDER_BACK, WIA_CATEGORY_FINISHED_FILE e WIA_CATEGORY_FILM. Non è supportato per gli elementi WIA_CATEGORY_FOLDER.

Tipo: VT_I4, accesso: lettura/scrittura, valori validi: WIA_PROP_RANGE
WIA_IPS_XRES
ScannerPictureXres

Contiene la risoluzione orizzontale corrente, espressa in pixel per pollice, per il dispositivo. Un'applicazione imposta questa proprietà per impostare la risoluzione orizzontale. Il minidriver crea e gestisce questa proprietà.

Se il dispositivo può essere impostato su un solo valore, creare un tipo di WIA_PROP_LIST e inserirlo nel valore valido. Si tratta anche di un caso in cui un'impostazione di risoluzione dipende da un'altra risoluzione. La risoluzione verticale può dipendere dalla risoluzione orizzontale.

Obbligatorio per tutti gli elementi abilitati per l'acquisizione; ovvero gli elementi nelle categorie: WIA_CATEGORY_FLATBED, WIA_CATEGORY_FEEDER, WIA_CATEGORY_FEEDER_FRONT, WIA_CATEGORY_FEEDER_BACK, WIA_CATEGORY_FINISHED_FILE e WIA_CATEGORY_FILM. Non è supportato per gli elementi WIA_CATEGORY_FOLDER.

Tipo: VT_I4, accesso: di sola lettura/scrittura o di sola lettura, valori validi: WIA_PROP_RANGE o WIA_PROP_LIST
WIA_IPS_XSCALING
ScannerPictureXscaling

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

 

Imposta il ridimensionamento orizzontale, come percentuale, che può essere applicato alle immagini analizzate all'interno del dispositivo scanner o del relativo driver.

Questa proprietà è facoltativa per tutti gli elementi abilitati per l'acquisizione; ovvero elementi di tipi WIA_CATEGORY_FLATBED, WIA_CATEGORY_FEEDER, WIA_CATEGORY_FEEDER_FRONT, WIA_CATEGORY_FEEDER_BACK e WIA_CATEGORY_FILM.

Tipo: VT_I4, accesso: lettura/scrittura o sola lettura, valori validi: WIA_PROP_LIST o WIA_PROP_RANGE.

I valori possono essere compresi tra 1 e il massimo VT_I4 (0xFFFF). Ad esempio, 100 significa che non è possibile ridimensionare, 050 significa ridurre il 50% delle dimensioni orignali e 200 significa aumentare fino al 200% delle dimensioni originali.
WIA_IPS_YEXTENT
ScannerPictureYextent

Contiene l'altezza corrente, in pixel, dell'immagine selezionata da acquisire. Un'applicazione imposta questa proprietà per contrassegnare l'altezza di un'area di selezione. Questa proprietà deve essere d'accordo con il valore della proprietà WIA_IPA_PIXELS_PER_LINE . Il minidriver crea e gestisce questa proprietà.

Obbligatorio per tutti gli elementi abilitati per l'acquisizione; ovvero gli elementi nelle categorie: WIA_CATEGORY_FLATBED, WIA_CATEGORY_FEEDER, WIA_CATEGORY_FEEDER_FRONT, WIA_CATEGORY_FEEDER_BACK e WIA_CATEGORY_FILM.

Tipo: VT_I4, accesso: lettura/scrittura, valori validi: WIA_PROP_RANGE
WIA_IPS_YPOS
ScannerPictureYpos

Coordinata y corrente, in pixel, dell'angolo superiore sinistro dell'immagine selezionata. Un'applicazione imposta questa proprietà per contrassegnare l'angolo superiore sinistro dell'area di selezione. Il minidriver crea e gestisce questa proprietà.

Obbligatorio per tutti gli elementi abilitati per l'acquisizione; ovvero gli elementi nelle categorie: WIA_CATEGORY_FLATBED, WIA_CATEGORY_FEEDER, WIA_CATEGORY_FEEDER_FRONT, WIA_CATEGORY_FEEDER_BACK, WIA_CATEGORY_FINISHED_FILE e WIA_CATEGORY_FILM. Non è supportato per gli elementi WIA_CATEGORY_FOLDER.

Tipo: VT_I4, accesso: lettura/scrittura, valori validi: WIA_PROP_RANGE
WIA_IPS_YRES
ScannerPictureYres

Contiene la risoluzione verticale corrente, in pixel per pollice, per il dispositivo. Un'applicazione imposta questa proprietà per impostare la risoluzione verticale. Il minidriver crea e gestisce questa proprietà.

Se il dispositivo può essere impostato su un solo valore, creare un tipo di WIA_PROP_LIST e inserirlo nel valore valido. Si tratta anche di un caso in cui un'impostazione di risoluzione dipende da un'altra risoluzione. La risoluzione orizzontale può dipendere dalla risoluzione verticale.

Obbligatorio per tutti gli elementi abilitati per l'acquisizione; ovvero gli elementi nelle categorie: WIA_CATEGORY_FLATBED, WIA_CATEGORY_FEEDER, WIA_CATEGORY_FEEDER_FRONT, WIA_CATEGORY_FEEDER_BACK, WIA_CATEGORY_FINISHED_FILE e WIA_CATEGORY_FILM. Non è supportato per gli elementi WIA_CATEGORY_FOLDER.

Tipo: VT_I4, accesso: di sola lettura/scrittura o di sola lettura, valori validi: WIA_PROP_RANGE o WIA_PROP_LIST
WIA_IPS_YSCALING
ScannerPictureYscaling

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

 

Imposta il ridimensionamento verticale, come percentuale, che può essere applicato alle immagini analizzate all'interno del dispositivo scanner o al relativo driver.

Questa proprietà è facoltativa per tutti gli elementi abilitati per l'acquisizione; ovvero elementi di tipi WIA_CATEGORY_FLATBED, WIA_CATEGORY_FEEDER, WIA_CATEGORY_FEEDER_FRONT, WIA_CATEGORY_FEEDER_BACK e WIA_CATEGORY_FILM.

Tipo: VT_I4, accesso: sola lettura/scrittura o sola lettura, valori validi: WIA_PROP_LIST o WIA_PROP_RANGE .

I valori possono essere compresi tra 1 e massimo VT_I4 (0xFFFF). Ad esempio, 100 non significa ridimensionamento, il 050 significa ridurre il 50% delle dimensioni orignali e il 200 significa aumentare fino al 200% delle dimensioni originali.

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