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:

[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

Vedi anche

MINIDRV_TRANSFER_CONTEXT