MicroEntry-Funktion (wiamicro.h)

Artikel
02/07/2025

Die MicroEntry--Funktion reagiert auf Befehle, die vom WIA Flatbed-Treiber gesendet werden.

Syntax

WIAMICRO_API HRESULT MicroEntry(
            LONG lCommand,
  [in, out] PVAL pValue
);

Parameter

lCommand

Gibt einen Befehl an, der vom WIA Flatbed-Treiber an den Mikrodriver ausgegeben wird.

[in, out] pValue

Verweist auf eine VAL- Struktur, die verwendet wird, um Informationen zwischen dem WIA Flatbed-Treiber und dem Mikrodriver zu übergeben.

Rückgabewert

Wenn die Funktion erfolgreich ist, wird S_OK zurückgegeben. Wenn ein übergebener Befehl nicht unterstützt wird, gibt die Funktion E_NOTIMPL zurück. Für jeden Fehler müssen Fehlerinformationen in das lVal Mitglied der VAL-Struktur eingefügt werden, auf das durch pValueverwiesen wird.

Bemerkungen

Diese Funktion führt je nach dem im lCommand Parameter übergebenen Befehl viele verschiedene Aufgaben aus. Eine Liste dieser Befehle finden Sie im WIA Microdriver Commands Referenzabschnitt.

An die Funktion werden zwei Strukturen übergeben. Eine VAL--Struktur wird im pValue Zeiger übergeben, und das pScanInfo Element der VAL-Struktur verweist auf eine SCANINFO Struktur. Die VAL-Struktur wird verwendet, um Informationen zwischen dem WIA Flatbed Driver und dem Microdriver zu übergeben. Die SCANINFO-Struktur wird verwendet, um Parameter einer Scandatenerfassung zu speichern und zu kommunizieren. Viele der Befehle, die an diese Funktion übergeben wurden, legen Werte in der SCANINFO-Struktur fest.