Condividi tramite

Libreria dei servizi driver WIA

  • Articolo

La libreria di servizi driver WIA contiene funzioni che un minidriver WIA può chiamare per assistenza per eseguire le attività seguenti:

Un minidriver WIA chiama la maggior parte di queste funzioni dai metodi di interfaccia IWiaMiniDrv in base alle esigenze. Ogni minidriver WIA, tuttavia, deve chiamare la funzione wiasCreateDrvItem nel metodo IWiaMiniDrv::d rvInitializeWia per creare elementi driver. Ogni chiamata riuscita a una funzione wiasCreateDrvItem crea un oggetto elemento IWiaDrvItem , usato nell'albero degli elementi del minidriver. Diversi metodi di interfaccia IWiaDrvItem hanno un parametro di tipo IWiaDrvItem, tra cui IWiaDrvItem:: AddItemToFolder, IWiaDrvItem::GetFirstChildItem, IWiaDrvItem::GetNextSiblingItem e IWiaDrvItem::GetParentItem. Inoltre, la funzione wiasGetDrvItem ha un parametro di questo tipo.

La libreria dei servizi driver fornisce le funzioni seguenti.

Compilare e gestire un albero di elementi

Funzione Descrizione
wiasCreateChildAppItem Crea un nuovo elemento dell'applicazione e lo inserisce come figlio dell'elemento specificato (padre).
wiasCreateDrvItem Crea un oggetto IWiaDrvItem .
wiasGetChildrenContexts Recupera una matrice di contesti di elemento appartenenti agli elementi figlio dell'elemento corrente.
wiasGetContextFromName Recupera il contesto dell'elemento per un nome di elemento.
wiasGetDrvItem Recupera un elemento del driver.
wiasGetRootItem Recupera il contesto dell'elemento radice di un elemento WIA specificato.

Errori di log e messaggi di traccia

Funzione Descrizione
wiasCreateLogInstance Crea un'istanza di un oggetto di registrazione.
wiasDebugError Stampa una stringa di errore di debug nella console di debug Gestione dispositivi. Il colore di output è sempre rosso. Questa funzione viene fornita solo per la compatibilità. È consigliabile usare WIAS_ERROR .
wiasDebugTrace Stampa una stringa di traccia di debug nella console di debug Gestione dispositivi. Questa funzione viene fornita solo per la compatibilità. È consigliabile usare WIA_TRACE .
wiasFormatArgs Formatta un elenco di argomenti in una stringa in pacchetto per la registrazione.
wiasPrintDebugHResult Stampa una stringa HRESULT nella console di debug Gestione dispositivi. Questa funzione viene fornita solo per la compatibilità. È obsoleto e non è più supportato. Usare invece WIAS_LHRESULT .

Proprietà dell'elemento di lettura e archiviazione

Funzione Descrizione
wiasCreatePropContext Alloca un contesto di proprietà per indicare quale delle proprietà di un elemento cambia.
wiasFreePropContext Rilascia la memoria occupata da una struttura WIA_PROPERTY_CONTEXT .
wiasGetChangedValueFloat Determina se una proprietà con un valore a virgola mobile è stata modificata da un'applicazione.
wiasGetChangedValueGuid Determina se una proprietà con un valore GUID è stata modificata da un'applicazione.
wiasGetChangedValueLong Determina se una proprietà con un valore intero lungo è stata modificata da un'applicazione.
wiasGetChangedValueStr Determina se una proprietà con un valore stringa è stata modificata da un'applicazione.
wiasGetItemType Indica un elemento radice o figlio.
wiasGetPropertyAttributes Recupera i flag di accesso e i valori validi per un set di proprietà.
wiasIsPropChanged Verifica se la proprietà specificata è stata modificata da un'applicazione.
wiasReadMultiple Legge più proprietà da un elemento WIA.
wiasReadPropBin Legge una singola proprietà binaria da un elemento WIA.
wiasReadPropFloat Recupera un valore della proprietà a virgola mobile da un elemento WIA.
wiasReadPropGuid Recupera un valore della proprietà GUID da un elemento WIA.
wiasReadPropLong Recupera un valore di proprietà integer lungo da un elemento WIA.
wiasReadPropStr Recupera un valore della proprietà stringa da un elemento WIA.
wiasSetItemPropAttribs Imposta i flag di accesso e i valori validi per il set di proprietà di un elemento.
wiasSetItemPropNames Scrive i nomi delle proprietà in proprietà dell'elemento.
wiasSetPropChanged Modifica un contesto di proprietà per indicare che viene modificata una proprietà.
wiasSetPropertyAttributes Imposta i flag di accesso e i valori delle proprietà di un elemento.
wiasSetValidFlag Imposta i valori validi per una proprietà WIA_PROP_FLAG.
wiasSetValidListFloat Imposta i valori validi per una proprietà WIA_PROP_LIST di tipo sub-VT_R4.
wiasSetValidListGuid Imposta i valori validi per una proprietà WIA_PROP_LIST di sottotipo VT_CLSID.
wiasSetValidListLong Imposta i valori validi per una proprietà WIA_PROP_LIST di tipo sub-VT_I4.
wiasSetValidListStr Imposta i valori validi per una proprietà WIA_PROP_LIST di tipo sub-VT_BSTR.
wiasSetValidRangeFloat Specifica l'intervallo di valori validi per una proprietà WIA_PROP_RANGE di sottotipo VT_R4.
wiasSetValidRangeLong Specifica l'intervallo di valori validi per una proprietà WIA_PROP_RANGE di sottotipo VT_I4.
wiasUpdateValidFormat Aggiornamenti il formato valido del contesto della proprietà per il minidriver corrente.
wiasValidateItemProperties Convalida un elenco di proprietà di elementi semplici rispetto ai valori validi correnti.
wiasWriteMultiple Scrive più valori di proprietà in un elemento WIA (le proprietà possono essere di tipi diversi).
wiasWritePropBin Scrive un singolo valore di proprietà binaria in un elemento WIA.
wiasWritePropFloat Scrive un valore della proprietà a virgola mobile in un elemento WIA.
wiasWritePropGuid Scrive un valore della proprietà GUID in un elemento WIA.
wiasWritePropLong Scrive un valore di proprietà integer lungo in un elemento WIA.
wiasWritePropStr Scrive un valore della proprietà stringa in un elemento WIA.

Aggiornare e trasferire i dati

Funzione Descrizione
wiasDownSampleBuffer Accetta in un buffer di dati pixel e lo riduce alla dimensione specificata.
wiasGetImageInformation Recupera le informazioni sul contesto di trasferimento da un elemento.
wiasParseEndorserString Analizza una stringa di approvazione, sostituendo i token definiti dal servizio WIA e definiti dal fornitore nella stringa con valori associati ai token.
wiasSendEndOfPage Chiama la routine di callback client durante un trasferimento dati, inviando il numero di pagine totale corrente.
wiasUpdateScanRect Aggiornamenti le dimensioni dell'area di analisi del dispositivo di scansione.
wiasWriteBufToFile Scrive il contenuto di un buffer di pagina temporaneo in un file di immagine.
wiasWritePageBufToFile Scrive il contenuto di un buffer di pagina temporaneo in un file di immagine. Usare questa funzione per scrivere una pagina in un file TIFF a più pagine.