Condividi tramite


Aggiungere proprietà WIA a un elemento WIA

Ogni elemento WIA contiene proprietà WIA. Un'applicazione legge e scrive le proprietà degli elementi WIA per configurare il minidriver WIA. Il servizio WIA chiama il metodo IWiaMiniDrv::d rvInitItemProperties una volta per ogni elemento a cui l'applicazione accede, per inizializzare le proprietà dell'elemento del minidriver WIA. Se un'applicazione non legge o scrive proprietà WIA in un elemento, questo metodo non viene chiamato per tale elemento. Il contesto dell'elemento a cui punta il parametro pWiasContext indica l'elemento che verrà inizializzato con le proprietà WIA.

Il metodo IWiaMiniDrv::d rvInitItemProperties deve eseguire le attività seguenti:

  1. Usare i dati ricevuti nel parametro pWiasContext per determinare il tipo di elemento. Il minidriver WIA può ottenere l'interfaccia COM IWiaDrvItem chiamando wiasGetDrvItem. Dopo aver ottenuto questa interfaccia, è possibile chiamare il metodo IWiaDrvItem::GetItemFlags per determinare il tipo di elemento WIA.

  2. Creare una matrice di nomi di proprietà e ID di proprietà che descrivono il set di proprietà completo necessario per l'elemento corrente. Dopo aver creato queste matrici, il minidriver WIA deve chiamare la funzione del servizio wiasSetItemPropNames . Questa funzione indica al servizio WIA di compilare un set di proprietà WIA in base alle matrici create. Questa funzione deve essere sempre chiamata prima di wiasWriteMultiple e wiasSetItemPropAttribs.

  3. Scrivere i valori iniziali o predefiniti impostando i valori sul set di proprietà WIA appena creato. Il minidriver WIA deve chiamare la funzione del servizio wiasWriteMultiple per impostare i valori iniziali. Questa funzione deve essere sempre chiamata prima di wiasSetItemPropAttribs.

  4. Scrivere i valori validi e i diritti di accesso per ogni proprietà. Il minidriver WIA deve chiamare la funzione del servizio wiasSetItemPropAttribs per impostare i diritti di accesso e i valori validi.

Le applicazioni sono responsabili della lettura (e della rilettura) di tutte le proprietà da cui dipendono, consentendo quindi all'applicazione di intercettare eventuali modifiche nei valori delle proprietà. Gli scanner e le fotocamere hanno un set di proprietà necessarie. Queste proprietà sono elencate in Informazioni sulle proprietà WIA.

Alcune proprietà hanno dipendenze da altre proprietà. Ad esempio, la proprietà format dipende dalla proprietà tymed . Queste dipendenze tra proprietà sono descritte in Proprietà WIA.