Funzione wiasGetImageInformation (wiamdef.h)
La funzione wiasGetImageInformation recupera le informazioni sul contesto di trasferimento da un elemento.
Sintassi
HRESULT wiasGetImageInformation(
[in] BYTE *pWiasContext,
LONG lFlags,
[in, out] PMINIDRV_TRANSFER_CONTEXT pmdtc
);
Parametri
[in] pWiasContext
Puntatore a un contesto di elemento WIA.
lFlags
Specifica i flag operativi. Attualmente è definito solo il flag seguente:
| Contrassegno | Significato |
|---|---|
| WIAS_INIT_CONTEXT | Inizializzare la struttura MINIDRV_TRANSFER_CONTEXT. |
[in, out] pmdtc
Puntatore a una struttura MINIDRV_TRANSFER_CONTEXT . Al termine della restituzione, questa struttura contiene le informazioni sull'elemento dell'immagine richiesto.
Valore restituito
In caso di esito positivo, la funzione restituisce S_OK.
Se la funzione ha esito negativo, restituisce un errore COM standard o uno dei codici di errore WIA.
Commenti
Questa funzione usa una struttura MINIDRV_TRANSFER_CONTEXT per calcolare le dimensioni dell'immagine dell'elemento e dell'intestazione dell'elemento. Inoltre, può facoltativamente compilare un'intestazione di immagine se il formato dell'immagine richiede un'intestazione dati. L'intestazione verrà copiata nel buffer se il membro pTransferBuffer della struttura MINIDRV_TRANSFER_CONTEXT non è NULL. Quando si usano formati di immagine (ad esempio JPEG) che non hanno un'intestazione, le dimensioni dell'intestazione nel membro lHeaderSize della struttura MINIDRV_TRANSFER_CONTEXT vengono segnalate come zero.
Per i formati di immagine in cui le dimensioni finali effettive dell'immagine non sono note fino a quando non vengono acquisiti i dati, come con TIFF a più pagine e i formati compressi, il membro lItemSize della struttura MINIDRV_TRANSFER_CONTEXT viene segnalato come zero. Il membro lImageSize viene segnalato come dimensione, in byte, dell'immagine non compressa in una singola pagina.
Se WIAS_INIT_CONTEXT viene specificato nel parametro lFlags , la struttura MINIDRV_TRANSFER_CONTEXT a cui punta il parametro pmdtc viene compilata con informazioni derivate dalle proprietà dell'immagine dell'elemento. Questo flag deve essere usato quando un minidriver ha allocato un nuovo contesto.
Requisiti
| Requisito | Valore |
|---|---|
| Piattaforma di destinazione | Desktop |
| Intestazione | wiamdef.h (include Wiamdef.h) |
| Libreria | Wiaservc.lib |
| DLL | Wiaservc.dll |