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:
| Flag | Bedeutung |
|---|---|
| WIAS_INIT_CONTEXT | Initialisieren Sie die MINIDRV_TRANSFER_CONTEXT-Struktur. |
[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
| Anforderung | Wert |
|---|---|
| Zielplattform | Desktop |
| Kopfzeile | wiamdef.h (einschließlich Wiamdef.h) |
| Bibliothek | Wiaservc.lib |
| DLL | Wiaservc.dll |