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:
| Bandiera | Significato |
|---|---|
| WIAS_INIT_CONTEXT | Inizializzare la struttura MINIDRV_TRANSFER_CONTEXT. |
[in, out] pmdtc
Puntatore a una struttura MINIDRV_TRANSFER_CONTEXT. Al momento della restituzione, questa struttura contiene le informazioni richieste relative all'elemento immagine.
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 .
Osservazioni
Questa funzione usa una struttura MINIDRV_TRANSFER_CONTEXT per calcolare le dimensioni dell'immagine dell'elemento e delle intestazioni degli elementi. Inoltre, può facoltativamente compilare un'intestazione di immagine se il formato dell'immagine richiede un'intestazione di 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 dopo l'acquisizione dei dati, come per i formati TIFF a più pagine e 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.
Fabbisogno
| Requisito | Valore |
|---|---|
| piattaforma di destinazione | Desktop |
| intestazione | wiamdef.h (include Wiamdef.h) |
| libreria | Wiaservc.lib |
| dll | Wiaservc.dll |