wiasGetImageInformation-Funktion (wiamdef.h)

Die wiasGetImageInformation-Funktion ruft Übertragungskontextinformationen aus einem Element ab.

Syntax

HRESULT wiasGetImageInformation(
  [in]      BYTE                      *pWiasContext,
            LONG                      lFlags,
  [in, out] PMINIDRV_TRANSFER_CONTEXT pmdtc
);

Parameter

[in] pWiasContext

Zeiger auf einen WIA-Elementkontext.

lFlags

Gibt Betriebsflags an. Derzeit wird nur das folgende Flag definiert:

[in, out] pmdtc

Zeiger auf eine MINIDRV_TRANSFER_CONTEXT-Struktur . Nach der Rückgabe enthält diese Struktur die angeforderten Bildelementinformationen.

Rückgabewert

Bei Erfolg gibt die Funktion S_OK zurück.

Wenn die Funktion fehlschlägt, gibt sie einen COM-Standardfehler oder einen der WIA-Fehlercodes zurück.

Hinweise

Diese Funktion verwendet eine MINIDRV_TRANSFER_CONTEXT-Struktur zum Berechnen von Elementbild- und Elementheadergrößen. Darüber hinaus kann es optional einen Bildheader ausfüllen, wenn das Bildformat einen Datenheader erfordert. Der Header wird in den Puffer kopiert, wenn das pTransferBuffer-Element der MINIDRV_TRANSFER_CONTEXT-Struktur nicht NULL ist. Bei Verwendung von Bildformaten (z. B. JPEG), die über keinen Header verfügen, wird die Headergröße im lHeaderSize-Element der MINIDRV_TRANSFER_CONTEXT-Struktur als Null gemeldet.

Bei Bildformaten, bei denen die tatsächliche endgültige Größe des Bilds erst nach der Datenerfassung bekannt ist, wie bei mehrseitigem TIFF und komprimierten Formaten, wird das lItemSize-Element der MINIDRV_TRANSFER_CONTEXT-Struktur als 0 gemeldet. Das lImageSize-Element wird als die Größe des nicht komprimierten Bilds auf einer einzelnen Seite in Bytes gemeldet.

Wenn WIAS_INIT_CONTEXT im lFlags-Parameter angegeben ist, wird die MINIDRV_TRANSFER_CONTEXT Struktur, auf die der pmdtc-Parameter verweist, mit Informationen gefüllt, die von den Bildeigenschaften des Elements abgeleitet werden. Dieses Flag sollte verwendet werden, wenn ein Minidriver einen neuen Kontext zugewiesen hat.

Anforderungen

Weitere Informationen

MINIDRV_TRANSFER_CONTEXT