Costanti comuni delle proprietà dell'elemento WIA
Le costanti della proprietà del dispositivo seguenti devono essere supportate da tutte le interfacce IWiaItem, IWiaItem2 e IWiaDrvItem Interface , a meno che non diversamente specificato nelle relative descrizioni.
Il prefisso "WIA_IPA_" indica una proprietà dell'elemento per tutti i dispositivi ed è la convenzione di denominazione usata in C/C++. A scopo di scripting, queste costanti usano il prefisso "Picture" 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 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
Questo flag controlla l'accesso all'elemento e se l'elemento viene eliminato. Obbligatorio per tutti gli elementi WIA 2.0. Tipo: VT_I4; Proprietà di sola lettura/scrittura o di sola lettura, a seconda della capacità dell'elemento di modificare i diritti di accesso; Valori validi: WIA_PROP_FLAG La tabella seguente include i cinque flag validi con questa proprietà.
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
Questa proprietà è riservata per uso futuro e non viene implementata in questo momento. Tipo: VT_I4, Accesso: Sola lettura, Valori validi: WIA_PROP_NONE |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
Contiene il numero di bit per canale per l'immagine. Il minidriver crea e gestisce questa proprietà. Obbligatorio per tutti gli elementi di immagine archiviati o abilitati per l'acquisizione di WINDOWS 2.0. Tipo: VT_I4, Accesso: Sola lettura, Valori validi: WIA_PROP_NONE |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
Contiene le dimensioni del buffer, in byte, utilizzate durante il trasferimento dei dati. Il minidriver crea e gestisce questa proprietà. Un'applicazione può leggere questa proprietà per determinare le dimensioni del buffer specificate dal driver per i trasferimenti di dati. Il servizio WIA legge anche questa proprietà per allocare memoria per il minidriver durante il trasferimento dei dati Facoltativo per tutti gli elementi WIA 2.0 abilitati per il trasferimento. Tipo: VT_I4, Accesso: Sola lettura, Valori validi: WIA_PROP_NONE
Nota: |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
Contiene il numero di byte in una riga di analisi dell'immagine. Il minidriver crea e gestisce questa proprietà. Facoltativo per tutti gli elementi WIA 2.0. Tipo: VT_I4, Accesso: Sola lettura, Valori validi: WIA_PROP_NONE |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
Contiene il numero di canali per pixel per l'immagine. Il minidriver crea e gestisce questa proprietà. Obbligatorio per tutti gli elementi di immagine archiviati o abilitati per l'acquisizione di WINDOWS 2.0. Tipo: VT_I4, Accesso: Sola lettura, Valori validi: WIA_PROP_NONE |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
Questa proprietà è riservata per uso futuro e non viene implementata in questo momento. Tipo: VT_I4, Accesso: Sola lettura, Valori validi: WIA_PROP_NONE |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
Contiene il tipo di compressione corrente utilizzato. Il minidriver crea e gestisce questa proprietà. Un'applicazione legge questa proprietà per determinare il tipo di compressione dell'immagine o imposta questa proprietà per configurare l'impostazione di compressione. Tipo: VT_I4, accesso: lettura/scrittura, valori validi: WIA_PROP_LIST Nella tabella seguente sono presenti le costanti valide con questa proprietà. Il simbolo V indica che la costante è supportata solo in Windows Vista e versioni successive. È disponibile solo tramite l'interfaccia IWiaItem2 .
[! Nota] Quando questa proprietà è WIA_COMPRESSION_NONE e WIA_IPA_FORMAT è WiaImgFmt_PDFA o WiaImgFmt_XPS; quindi WIA_COMPRESSION_NONE significa che la modalità di compressione non è definita e lo scanner deve decidere su una modalità. WIA_COMPRESSION_AUTO è un nuovo valore di proprietà definito per la proprietà WIA_IPA_COMPRESSION. Questo valore è valido per tutti gli elementi dell'origine dati dell'immagine programmabili, tra cui flatbed e feeder. Quando questo valore è supportato dal mini-driver WIA, il client dell'applicazione WIA può impostare WIA_IPA_COMPRESSION per abilitare il rilevamento automatico della modalità di compressione nel dispositivo. WIA_COMPRESSION_AUTO può funzionare con e senza colore automatico completo supportato o abilitato (WIA_DATA_AUTO e WIA_DEPTH_AUTO). WIA_COMPRESSION_AUTO è più utile con i formati di file di trasferimento che supportano più tipi di dati e profondità bit, ad esempio WiaImgFmt_RAW. Per altre informazioni sui formati di file di trasferimento, vedere WIA_IPA_FORMAT in questa tabella. È opitonale per il mini-driver WIA per portare WIA_COMPRESSION_AUTO. Quando è supportato, il mini-driver WIA non deve mai impostarlo come valore predefinito per WIA_IPA_COMPRESSION; solo l'applicazione WIA può impostare questo valore. |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
Contiene l'impostazione del tipo di dati corrente per il dispositivo. Il minidriver crea e gestisce questa proprietà. Un'applicazione legge questa proprietà per determinare il tipo di dati dell'immagine. Un'applicazione scrive questa proprietà per impostare il tipo di dati corrente dell'immagine da trasferire. Questa proprietà è necessaria per tutti gli elementi WIA 2.0. Deve essere di lettura/scrittura per tutti gli elementi abilitati per l'acquisizione di WIA 2.0 e di sola lettura per gli elementi di archiviazione WIA 2.0. Tipo: VT_I4; Accesso per sistemi operativi pre-Windows Vista: questa proprietà è di sola lettura per fotocamere e lettura/scrittura per gli scanner; Accesso per Windows Vista e versioni successive: questa proprietà è di sola lettura per WIA_CATEGORY_FOLDER e WIA_CATEGORY_FINISHED_FILE elementi e lettura/scrittura per tutte le altre categorie di elementi WIA 2.0; Valori validi: WIA_PROP_LIST La tabella seguente contiene le sei costanti valide con quando WIA_IPA_FORMAT non è impostata su WiaImgFmt_RAW .
La proprietà WIA_IPA_DATATYPE viene usata anche per descrivere il tipo di trasferimento dati RAW da usare quando l'applicazione imposta WiaImgFmt_RAW . Il driver deve impostare la proprietà WIA_IPA_DATATYPE su un elenco di valori consentiti da cui l'applicazione può selezionarne una. Se il dispositivo può essere impostato su un solo valore, creare un tipo di WIA_PROP_LIST e inserire il valore valido in esso. Controllare la proprietà WIA_IPA_DEPTH per determinare la profondità del bit. Questa proprietà contiene in genere un singolo valore per le fotocamere. La tabella seguente elenca le costanti valide con WIA_IPA_DATATYPE quando WIA_IPA_FORMAT è impostata su WiaImgFmt_RAW .
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
WIA_IPA_DEPTH contiene l'impostazione di profondità bit di un'immagine. Il minidriver crea e gestisce questa proprietà. Un'applicazione legge questa proprietà per determinare l'impostazione di profondità bit dell'immagine. L'applicazione potrebbe anche essere in grado di impostare questo valore sulla profondità di bit desiderata. Se il dispositivo può essere impostato su un solo valore, creare un tipo di WIA_PROP_LIST e inserire il valore valido in esso. Questa proprietà è necessaria per tutti gli elementi WIA 2.0. Deve essere di lettura/scrittura per tutti gli elementi abilitati per l'acquisizione di WIA 2.0 e di sola lettura per gli elementi di archiviazione WIA 2.0. Tipo: VT_I4; Accesso per i sistemi operativi pre-Windows Vista: lettura/scrittura; Accesso per Windows Vista e versioni successive: questa proprietà è di sola lettura per WIA_CATEGORY_FOLDER e WIA_CATEGORY_FINISHED_FILE elementi e lettura/scrittura per tutte le altre categorie di elementi WIA 2.0; Valori validi: WIA_PROP_LIST WIA_DEPTH_AUTO è definito come 0 bit per pixel ed è un nuovo valore di proprietà definito per la WIA_IPA_DEPTH. Questo valore è valido per tutti gli elementi dell'origine dati dell'immagine programmabili, tra cui flatbed e feeder. Quando WIA_DEPTH_AUTO è supportato dal mini-driver WIA, il client dell'applicazione WIA può impostare WIA_IPA_DEPTH su questo valore, per abilitare il rilevamento automatico dei colori nel dispositivo. Quando WIA_DEPTH_AUTO è impostato, il mini-driver WIA deve aggiornare WIA_IPA_DATATYPE nello stesso elemento in WIA_DATA_AUTO (che deve essere un valore supportato, se il dispositivo supporta il colore automatico). WIA_DEPTH_AUTO è un valore facoltativo, ma diventa necessario quando WIA_DATA_AUTO è supportato per WIA_IPA_DATATYPE. |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
Contiene l'estensione del nome file per un formato di file specifico. Il minidriver crea e gestisce questa proprietà. Facoltativo per tutti gli elementi WIA 2.0 abilitati per il trasferimento. Tipo: VT_BSTR, accesso: sola lettura, valori validi: WIA_PROP_NONE Il driver aggiorna questa proprietà per riflettere il valore corrente della proprietà WIA_IPA_FORMAT . Ad esempio, se WIA_IPA_FORMAT è WiaImgFmt_JPEG , WIA_IPA_FILENAME_EXTENSION deve essere jpg. Se WIA_IPA_FORMAT è WiaImgFmt_BMP , WIA_IPA_FILENAME_EXTENSION deve essere BMP.
Nota: Questa proprietà è consigliata per i driver che supportano formati standard e sono necessari per i driver che implementano formati definiti in modo personalizzato. Informa l'applicazione dell'estensione del nome file corretta da usare durante il trasferimento di file formattati privatamente. Ad esempio, se A. Datum Corporation ha creato un driver WIA che ha trasferito un file in un nuovo formato, l'azienda potrebbe specificare un'estensione di "adc". Ciò consente alle applicazioni di trasferire dati in tale formato a un file e di creare un nome file, ad esempio myfile.adc, utile per altri utenti che comprendono la nuova estensione. |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
Contiene il formato corrente dell'immagine da trasferire. Un'applicazione legge questa proprietà per determinare il formato dell'immagine che sta per ricevere. Un'applicazione scrive questa proprietà per impostare il formato. Questa proprietà dipende dalla proprietà WIA_IPA_TYMED . 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 inserire il valore valido in esso. Tipo: CLSID, Accesso: Lettura/scrittura, Valori validi: WIA_PROP_LIST Nella tabella seguente sono elencate le costanti valide con questa proprietà. L'asterisco * indica che la costante non è supportata in Windows Vista. È disponibile solo tramite l'interfaccia IWiaItem . L'asterisco doppio indica che la costante non è supportata in Windows Server 2003 o Windows Vista. Il simbolo V indica che la costante è supportata solo in Windows Vista e versioni successive. È disponibile solo tramite l'interfaccia IWiaItem2 .
Nota: |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
Contiene il nome completo dell'elemento (il nome dell'elemento insieme alle informazioni sul percorso). Il nome completo dell'elemento corrisponde al parametro bstrFullItemName della funzione dell'utilità del servizio wiasCreateDrvItem . Un'applicazione legge questa proprietà per determinare quale elemento è attualmente in uso e dove si trova tale elemento nell'albero degli elementi. Ogni elemento deve avere un nome univoco. Le applicazioni usano in genere il nome completo dell'elemento per cercare gli elementi nell'albero degli elementi. Il servizio WIA crea e gestisce questa proprietà. Obbligatorio per tutti gli elementi WIA 2.0. Tipo: VT_BSTR, Access: Sola lettura, Valori validi: WIA_PROP_NONE |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
Questa proprietà è riservata per uso futuro e non viene implementata in questo momento. Tipo: VT_I4, Accesso: Sola lettura, Valori validi: WIA_PROP_NONE |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
Contiene il nome del profilo ICM necessario per decodificare correttamente l'immagine. Un'applicazione legge questa proprietà per determinare il profilo ICM da usare durante l'elaborazione dell'immagine. Il servizio WIA crea e gestisce questa proprietà in base alla voce ICMProfiles nel file di installazione del driver. Tipo: VT_BSTR, Accesso: Sola lettura, Valori validi: WIA_PROP_NONE |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
Supportato solo in Windows Vista e versioni successive. Gli elementi WIA 2.0 sono raggruppati in categorie che definiscono come deve essere trattato o usato un oggetto IWiaItem2 . Ad esempio, se l'elemento rappresenta un feeder, l'applicazione deve aspettarsi che contenga le proprietà del feeder di documenti necessarie e funzioni come un feeder di documenti. Se l'elemento rappresenta un file completato, un'applicazione WIA 2.0 deve trattarla in questo modo, presupponendo che i dati siano statici e che si trovino nel dispositivo. Le regole per ogni elemento verranno definite nei singoli documenti di specifica. Obbligatorio per tutti gli elementi WIA 2.0. Tipo: VT_CLSID, Access: Sola lettura, Valori validi: GUID categoria di elementi |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
Contiene i flag descrittivi per un elemento WIA. I flag di elemento sono uguali a quelli nel parametro lObjectFlags della funzione dell'utilità del servizio wiasCreateDrvItem . Il servizio WIA crea e gestisce questa proprietà. Un'applicazione legge questa proprietà per determinare i valori del flag descrittivo dell'elemento. Tipo: VT_I4 Access: Sola lettura, Valori validi: WIA_PROP_NONE Nella tabella seguente sono presenti i flag validi con questa proprietà. Un asterisco * indica che il flag non è supportato in Windows Vista o versione successiva. È disponibile solo tramite l'interfaccia IWiaItem . Un asterisco doppio indica che il flag non è supportato in Windows Server 2003 o Windows Vista o versione successiva. Il simbolo V indica che il flag è supportato solo in Windows Vista e versioni successive. È disponibile solo tramite l'interfaccia IWiaItem2 .
Alcuni di questi flag sono obbligatori o facoltativi per gli elementi WIA 2.0, in base alla categoria dell'elemento, come illustrato in questa tabella.
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
Contiene il nome dell'elemento. Un'applicazione legge questa proprietà per determinare l'elemento attualmente in uso. Ogni elemento ha un nome univoco. Il servizio WIA crea e gestisce questa proprietà. Obbligatorio per tutti gli elementi WIA 2.0. Tipo: VT_BSTR, Access: Sola lettura, Valori validi: WIA_PROP_NONE |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
Contiene le dimensioni correnti, in byte, dei dati associati all'elemento. Il minidriver crea e gestisce questa proprietà. Contiene le dimensioni totali dei dati trasferiti. Se questo valore è zero, significa che il minidriver non contiene informazioni sulla dimensione esatta dei dati. Questa operazione è comune per i dati compressi. Un'applicazione legge questo valore per determinare le dimensioni dell'acquisizione prima che venga eseguita. Il servizio WIA legge questa proprietà per facilitare l'allocazione della memoria per i trasferimenti di dati. Per altre informazioni, vedere Trasferimento di dati a un'applicazione WIA se la proprietà è impostata su zero e TYMED è configurato per un trasferimento di file, il servizio WIA non alloca memoria per il minidriver WIA. Obbligatorio per tutti gli elementi WIA 2.0 abilitati per il trasferimento. Tipo: VT_I4, Accesso: Sola lettura, Valori validi: WIA_PROP_NONE |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
Contiene l'ora in cui l'immagine è stata originariamente acquisita. Il minidriver crea e gestisce questa proprietà. Questa proprietà deve essere segnalata come vettore di otto valori WORD sotto forma di struttura SYSTEMTIME (descritta nella documentazione di Platform SDK). Facoltativo per tutti gli elementi WIA 2.0. Tipo: VT_UI2 | VT_VECTOR Access: Lettura/Scrittura o Sola lettura, Valori validi: WIA_PROP_NONE |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
Supportato solo in Windows Vista e versioni successive. Specifica il numero di elementi archiviati nell'elemento WIA_CATEGORY_FOLDER. Tipo: VT_I4, Access: Lettura/Scrittura, Valori validi: WIA_PROP_NONE |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
Specifica la dimensione minima del buffer utilizzata nei trasferimenti di dati. Se il trasferimento dei dati viene eseguito tramite un meccanismo di callback, il valore della proprietà può essere pari a 64 KB. Tuttavia, se il trasferimento è nel file, il valore della proprietà è il numero di byte necessari per trasferire una pagina di dati alla volta. Il minidriver crea e gestisce questa proprietà WIA. Facoltativo per tutti gli elementi WIA 2.0 abilitati per il trasferimento. Tipo: VT_I4, Accesso: Sola lettura, Valori validi: WIA_PROP_NONE |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
Contiene il numero di righe contenute nell'immagine (altezza verticale dell'immagine in pixel). Il minidriver crea e gestisce questa proprietà. Facoltativo per tutti gli elementi WIA 2.0. Tipo: VT_I4, Accesso: Sola lettura, Valori validi: WIA_PROP_NONE |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
Contiene il numero di pixel in ogni riga dell'immagine (larghezza dell'immagine in pixel). Il minidriver crea e gestisce questa proprietà. Facoltativo per tutti gli elementi WIA 2.0. Tipo: VT_I4, Accesso: Sola lettura, Valori validi: WIA_PROP_NONE |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
Questa proprietà non è supportata in Windows Vista e versioni successive. Contiene le opzioni di compressione dei dati dell'immagine. Il minidriver crea e gestisce questa proprietà. Un'applicazione legge questa proprietà per determinare le opzioni di compressione delle immagini o imposta le opzioni di compressione delle immagini correnti. 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 posizionare il valore valido. Nella tabella seguente sono presenti le due costanti valide con questa proprietà.
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
Contiene il formato preferito per le immagini che questo minidriver trasferisce. Il minidriver crea e gestisce questa proprietà. Obbligatorio per tutti gli elementi WIA 2.0 abilitati per il trasferimento. Tipo: CLSID, Accesso: Sola lettura, Valori validi: WIA_PROP_NONE |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
Specifica un CLSID che rappresenta un set di valori di proprietà del dispositivo. Se un driver di dispositivo implementa questa funzionalità, le applicazioni usano questa proprietà per determinare se il dispositivo supporta un set di valori. Tipo: CLSID, Accesso: Sola lettura, Valori validi: WIA_PROP_LIST La tabella seguente contiene le 12 costanti valide con questa proprietà.
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
Supportato solo in Windows Vista e versioni successive. Contiene il numero di bit in ogni canale. Questa proprietà deve essere segnalata come vettore di tutti i valori BYTE presenti nei canali, in cui il primo BYTE corrisponde al numero di bit nel primo canale, il secondo byte al numero di bit nel secondo canale e così via. Ci devono essere tutte le voci che ci sono canali in base a WIA_IPA_CHANNELS_PER_PIXEL. Il driver imposta tale proprietà quando l'applicazione passa a WiaImgFmt_RAW. Per i sottotipi noti, sono presenti tutte le voci elencate nella tabella in WIA_IPA_RAW_SUBTYPE. Tipo: VT_UI1|VT_VECTOR, Access: Sola lettura, Valori validi: WIA_PROP_NONE |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
Questa proprietà è riservata per uso futuro e non viene implementata in questo momento. Tipo: VT_I4, Accesso: Sola lettura, Valori validi: WIA_PROP_NONE |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
Specifica se eliminare le pagine delle proprietà generali per gli elementi nel dispositivo. Questa proprietà è disponibile in Windows XP e versioni successive. Tipo: VT_I4, Accesso: Sola lettura, Valori validi: WIA_PROP_NONE Nella tabella seguente sono presenti le costanti valide con questa proprietà. L'asterisco * indica che la costante non è valida con Windows Vista e versioni successive. È disponibile solo tramite l'interfaccia IWiaItem .
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
Questa proprietà contiene l'impostazione del metodo di trasferimento. Il minidriver crea e gestisce questa proprietà. Un'applicazione legge questa proprietà per determinare il metodo di trasferimento dei dati del minidriver. Obbligatorio per tutti gli elementi WIA 2.0 abilitati per il trasferimento. Tipo: VT_I4, accesso: lettura/scrittura, valori validi: WIA_PROP_LIST Nella tabella seguente sono presenti le costanti valide con questa proprietà. L'asterisco * indica costanti non valide con Windows Vista e versioni successive. Sono disponibili solo tramite l'interfaccia IWiaItem .
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
Supportato solo in Windows Vista e versioni successive. Specifica il numero di byte da caricare per un elemento. Tipo: VT_I4, Access: Lettura/Scrittura, Valori validi: WIA_PROP_NONE |
Requisiti
| Requisito | valore |
|---|---|
| Client minimo supportato |
Windows Vista [solo app desktop] |
| Server minimo supportato |
Windows Server 2008 [solo app desktop] |
| Intestazione |
|