wiasGetImageInformation-Funktion (wiamdef.h)

Artikel
02/07/2025

Die wiasGetImageInformation Funktion ruft Kontextinformationen 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 Betriebskennzeichnungen an. Derzeit ist nur das folgende Flag definiert:

Flagge	Bedeutung
WIAS_INIT_CONTEXT	Initialisieren Sie die MINIDRV_TRANSFER_CONTEXT-Struktur.

[in, out] pmdtc

Zeiger auf eine MINIDRV_TRANSFER_CONTEXT Struktur. Bei 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, wird ein STANDARDMÄßIGer COM-Fehler oder eine der WIA-Fehlercodeszurückgegeben.

Bemerkungen

Diese Funktion verwendet eine MINIDRV_TRANSFER_CONTEXT Struktur zum Berechnen von Elementbild- und Elementkopfgrößen. Darüber hinaus kann es optional eine Bildüberschrift ausfüllen, wenn für das Bildformat eine Datenüberschrift erforderlich ist. Der Header wird in den Puffer kopiert, wenn das pTransferBuffer Member der MINIDRV_TRANSFER_CONTEXT Struktur nicht NULL-ist. Bei Verwendung von Bildformaten (z. B. JPEG), die keine Kopfzeile aufweisen, wird die Kopfzeilengröß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 mehrseitigen TIFF- und komprimierten Formaten, wird das lItemSize Member der MINIDRV_TRANSFER_CONTEXT Struktur als Null gemeldet. Das lImageSize Member wird als Größe des nicht komprimierten Bilds in Bytes auf einer einzelnen Seite gemeldet.

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

Anforderungen

Anforderung	Wert
Zielplattform-	Desktop
Header-	wiamdef.h (include Wiamdef.h)
Library	Wiaservc.lib
DLL-	Wiaservc.dll

Siehe auch

MINIDRV_TRANSFER_CONTEXT

Freigeben über