Erforderliche Befehle

Der folgende Satz erforderlicher Befehle muss von jedem Microdriver implementiert werden.

CMD_GETCAPABILITIES

Vom WIA Flatbed Driver aufgerufen, um Schaltflächenereignisinformationen abzurufen. Es sollten drei Elemente der übergebenen VAL-Struktur ausgefüllt werden: lVal sollte auf die Anzahl der Schaltflächen festgelegt werden; pGuid sollte auf ein Array von Ereignis-GUIDs festgelegt werden; ppButtonNames können optional auf ein WCHAR*-Array festgelegt werden, das die Schaltflächennamen in der gleichen Reihenfolge enthält wie in pGuid (z. B. "Scan Button" oder "Fax Button"). Wenn ppButtonNames auf NULL festgelegt ist, erstellt der WIA Flatbed Driver generische Schaltflächennamen. Die Arrays können als Reaktion auf CMD_INITIALIZE alloziert und in CMD_UNINITIALIZE freigegeben werden.

CMD_INITIALIZE

Wird vom WIA Flatbed Driver aufgerufen, um den Mikrodriver zu initialisieren und Geräte-E/A-Handles auf gültige Werte festzulegen. Dieser Befehl wird an den Microdriver gesendet, wenn der WIA-Dienst die Methode IWiaMiniDrv::d rvInitializeWia für den WIA Flatbed Driver aufruft.

Der WIA Flatbed Driver erstellt automatisch ein Geräte-E/A-Handle und fügt es in das DeviceIOHandles-Arraymember der übergebenen SCANINFO-Struktur bei Index 0 ein. Der Microdriver sollte diesen Handle verwenden, wenn er mit dem Gerät kommunizieren muss. Wenn der Microdriver zusätzliche Geräte-Handles benötigt (z. B. für die Verwendung mehrerer USB-Bulk-Pipes), können sie im DeviceIOHandles-Array bis zu einer maximalen Anzahl von MAX_IO_HANDLES erstellt und gespeichert werden. Der WIA Flatbed Treiber schließt das Handle automatisch bei Index 0, da er dieses Handle während der Initialisierung erstellt hat. Die anderen Handles müssen vom Mikrotreiber als Reaktion auf CMD_UNINITIALIZE geschlossen werden.

Im Rahmen dieses Befehls sollte der Microdriver auch alle Werte in der SCANINFO-Struktur initialisieren. Der Mikrotreiber sollte die Mitglieder SupportedDataTypes, IntensityRange, ContrastRange, BedWidth und BedHeight der SCANINFO-Struktur festlegen, damit der WIA-Flachbetttreiber diese Werte automatisch mit den zulässigen Bereichen für das Gerät abgleichen kann.

CMD_RESETSCANNER

Vom WIA Flatbed Driver aufgerufen, um das Gerät als Reaktion auf eine WIA-Serviceanfrage zurückzusetzen. Der Mikrotreiber sollte das Gerät in den Einschaltzustand versetzen. In Windows Vista verwendet der WIA Flatbed Driver diesen Befehl nicht. Microdriver sollten diesen Befehl jedoch weiterhin unterstützen, um den korrekten Betrieb in Windows XP und möglicherweise mit einer zukünftigen Version des WIA Flatbed Driver sicherzustellen, der diesen Befehl verwenden könnte.

CMD_SETDATATYPE

Vom WIA Flatbed Driver aufgerufen, um den Datentyp für den Scan festzulegen. Einer der folgenden Werte wird im lVal-Element der übergebenen VAL-Struktur übergeben:

• WIA_DATA_THRESHOLD − 1 Bit schwarz/weiß

• WIA_DATA_GRAYSCALE − 8-Bit-Graustufen

• WIA_DATA_COLOR − 24-Bit-Farbe

Der Microdriver sollte den Wert im DataType-Element der übergebenen SCANINFO-Struktur speichern.

CMD_SETCONTRAST

Vom WIA Flatbed Driver aufgerufen, um den Kontrastwert für den Scan festzulegen. Der gewünschte Kontrastwert wird im lVal-Element der übergebenen VAL-Struktur übergeben. Der Wert −1000 sollte als niedrigster Kontrastwert, 0 als Nominalwert und 1000 als maximaler Kontrast des Geräts interpretiert werden. Der Microdriver sollte den Wert im Contrast-Element der übergebenen SCANINFO-Struktur speichern.

Befehl_SetIntensität

Wird vom WIA Flatbed Driver aufgerufen, um den Intensitäts- oder Helligkeitswert für den Scan festzulegen. Der gewünschte Intensitätswert wird im lVal-Element der übergebenen VAL-Struktur übergeben. Der Wert −1000 sollte als niedrigster Helligkeitswert, 0 Nominalwert und 1000 der maximalen Helligkeit des Geräts interpretiert werden. Der Mikrodriver sollte den Wert im Intensitätselement der übergebenen SCANINFO-Struktur speichern.

CMD_SETXRESOLUTION

Vom WIA Flatbed Driver aufgerufen, um die horizontale Scanauflösung festzulegen. Die gewünschte Auflösung in Pixeln wird im lVal-Element der übergebenen VAL-Struktur übergeben. Der Microdriver sollte den Wert im XResolution-Element der übergebenen SCANINFO-Struktur speichern.

CMD_SETYRESOLUTION

Vom WIA Flatbed Driver aufgerufen, um die vertikale Scanauflösung festzulegen. Die gewünschte Auflösung in Pixeln wird im lVal-Element der übergebenen VAL-Struktur übergeben. Der Microdriver sollte den Wert im YResolution-Element der übergebenen SCANINFO-Struktur speichern.

CMD_STI_DEVICERESET

Wird vom WIA Flatbed Driver aufgerufen, um das Gerät als Reaktion auf eine Still Image (STI)-Anforderung zurückzusetzen. Dieser Befehl wird in der Regel nur einmal während der Initialisierung aufgerufen.

CMD_STI_DIAGNOSTIC

Wird vom WIA Flatbed Driver aufgerufen, wenn der Benutzer einen Test des Geräts anfordert.

CMD_UNINITIALIZE

Deinitialisieren Sie den Microdriver und schließen Sie die Geräte-E/A-Handles. Der WIA-Flatbed-Treiber schließt das Geräte-I/O-Handle automatisch im DeviceIOHandles-Arraymember des SCANINFO-Struktur-Elements am Index 0. Dieser Befehl wird an den Mikrodriver gesendet, wenn der WIA Flatbed Driver entladen wird.