Optionale Befehle

Die folgenden Befehle können vom Microdriver implementiert werden, dies ist jedoch nicht erforderlich.

CMD_GETSUPPORTEDFILEFORMATS

Wird vom WIA Flatbed Driver aufgerufen, um die Anzahl zusätzlicher Dateiformate abzurufen. Zwei Elemente der übergebenen VAL-Struktur sollten ausgefüllt werden: lVal sollte auf die Anzahl zusätzlicher Dateiformate festgelegt werden; pGuid sollte auf ein Array von Bildformat-GUIDs verweisen. Der für dieses Array zugewiesene Speicher gehört dem Microdriver und sollte nur von ihm freigegeben werden.

Bildformate werden in wiadef.h aufgeführt oder können als benutzerdefinierte Formate definiert werden. Da die Formate BMP (Datei) und MEMORYBMP (Speicher) erforderlich sind, fügt der WIA Flatbed Driver diese automatisch hinzu. Der Mikrotreiber sollte sie nicht zur erweiterten Liste hinzufügen.

Dieser Befehl ist optional, es sei denn, das Gerät kann zusätzliche Dateiformate unterstützen.

CMD_GETSUPPORTEDMEMORYFORMATS

Vom WIA Flatbed Driver aufgerufen, um die Anzahl zusätzlicher Speicherformate abzurufen. Zwei Elemente der übergebenen VAL-Struktur sollten ausgefüllt werden: lVal sollte auf die Anzahl zusätzlicher Speicherformate festgelegt werden; pGuid sollte auf ein Array von Bildformat-GUIDs verweisen. Der für dieses Array zugewiesene Speicher gehört dem Microdriver und sollte nur von ihm freigegeben werden.

Bildformate werden in wiadef.h aufgeführt oder können als benutzerdefinierte Formate definiert werden. Da die Formate BMP (Datei) und MEMORYBMP (Speicher) erforderlich sind, fügt der WIA Flatbed Driver diese automatisch hinzu. Der Microdriver sollte sie nicht zur erweiterten Liste hinzufügen.

Dieser Befehl ist optional, es sei denn, das Gerät kann zusätzliche Speicherformate unterstützen.

CMD_SETFORMAT

Der Klassentreiber sendet diesen Befehl, um das aktuelle Format wie von der Anwendung angefordert festzulegen. Das pGuid-Element der VAL-Struktur enthält die GUID des Bildformats. Der Microdriver sollte diese Bildformat-ID im privaten Kontext speichern, um die aktuelle Bildformateinstellung nachzuverfolgen.

Microdriver müssen diesen Befehl nur unterstützen, wenn sie erweiterte Formate melden. Da der Klassentreiber keine Möglichkeit hat, Daten in erweiterten Formaten zu validieren, liegt es in der Verantwortung des Microdrivers, die richtigen Daten zu generieren. Beim Übertragen von Daten in einem erweiterten Format sollten alle Daten übertragen werden, einschließlich Bildkopfzeilen. Wenn Ihr Treiber beispielsweise meldet, dass er das JPEG-Format unterstützt, müssen alle JPEG-Dateien übertragen werden, nicht nur die Bildbits.

Der Klassentreiber besitzt den Speicher, auf den das pGuid-Mitglied der VAL-Struktur verweist, sodass der Microdriver ihn nicht freigeben darf.

Beachten Sie, dass dieser Befehl keine Auswirkungen auf die Art und Weise hat, wie ein Mikrodriver auf Aufrufe seiner Scanfunktion reagiert. Wie üblich muss der Microdriver die Werte der Parameter "lPhase", "pScanInfo" und "lLength " dieser Funktion überprüfen und daten in den Puffern platzieren, auf die die pBuffer - und pReceived-Parameter verweisen.

Treiber, die nur Dateien in den WiaImgFmt_BMP- und WiaImgFmt_MEMORYBMP-Formaten (die Standardformate für Microdriver) unterstützen, können den befehl CMD_SETFORMAT empfangen. Diese Treiber können diesen Befehl ignorieren, da der Klassentreiber alle Datenübertragungen mit den Standardformaten verarbeitet.

CMD_SETSCANMODE

Vom WIA Flatbed Driver aufgerufen, um den Scanmodus (Vorschau oder endgültig) des Microdrivers-Geräts festzulegen. Das lVal-Element der VAL-Struktur enthält einen der folgenden Werte, die beide in wiamicro.h definiert sind:

• SCANMODE_PREVIEWSCAN − Vorschauscanmodus

• SCANMODE_FINALSCAN − Endgültiger Scanmodus

CMD_SETSTIDEVICEHKEY

Vom WIA Flatbed Driver aufgerufen, damit der Microdriver Registrierungseinträge im installierten Registrierungsabschnitt lesen kann. Dieser Befehl stellt die installierte Registrierungs-HKEY des STI-Geräts auf dem Microdriver bereit, sodass er auf private Registrierungswerte für sein Gerät zugreifen kann. Das pHandle-Element der VAL-Struktur wird einen Zeiger auf den HKEY enthalten, der dem WIA-Flachbetttreiber während der Methode IStiUSD::Initialize zugewiesen wird. Dies ist die oberste HKEY-Ebene des Abschnitts der installierten Geräte. Der DeviceData-Schlüssel kann direkt mit diesem HKEY geöffnet werden. Weitere Informationen finden Sie unter INF-Dateien für WIA-Geräte .