Freigeben über

Ereignisbefehle

  • Artikel

Die Befehle in diesem Abschnitt werden vom Microdriver für die Geräteereignisunterstützung verwendet.

CMD_GET_INTERRUPT_EVENT

Wird vom WIA-Flatbed Driver in einem separaten Thread aufgerufen, um die status von Schaltflächenereignissen zu überwachen, die Interrupts vom Gerät verwenden (d. a. für USB-Geräte, die Ereignisse über die Interruptpipe melden). Wenn Ihr Gerät nur die Abfrage unterstützt, muss dieser Befehl nicht implementiert werden, und E_NOTIMPL sollte zurückgegeben werden.

Zwei Ereignishandles werden an den Microdriver übergeben. Das lVal-Element der VAL-Struktur enthält ein Ereignishandle, das vom Microdriver mithilfe der SetEvent-Funktion signalisiert werden soll, wenn ein Schaltflächenereignis auftritt. Das Handle-Member der VAL-Struktur enthält ein Ereignishandle, das vom WIA-Flatbed Driver signalisiert wird, wenn der Treiber entladen oder heruntergefahren wird.

Das pGuid-Element der VAL-Struktur sollte so festgelegt werden, dass er auf die GUID der Schaltfläche verweist, die gedrückt wurde. Wenn keine Schaltfläche gedrückt wurde, sollte sie auf GUID_NULL festgelegt werden.

CMD_STI_GETSTATUS

Wird vom WIA-Flatbed Driver aufgerufen, um die Online-status des Geräts zu erhalten, und wenn das Gerät Über Drucktasten verfügt, um die Schaltfläche status zu erhalten.

Legen Sie den lVal-Member der übergebenen VAL-Struktur auf 1 fest, wenn Ihr Gerät online ist und ordnungsgemäß funktioniert. Wenn lVal auf einen anderen Wert als 1 festgelegt ist, gilt das Gerät als offline und schlägt den Gerätetest in Systemsteuerung fehl.

Wenn das Gerät Schaltflächen unterstützt, die keine Interrupts vom Gerät verwenden und eine Schaltfläche gedrückt wurde, sollte der pGuid-Member der übergebenen VAL-Struktur auf die GUID des Schaltflächenereignisses festgelegt werden. Wenn keine Schaltflächen gedrückt wurden, zeigen Sie pGuid auf den Wert GUID_NULL. Dies signalisiert, dass keine Ereignisse ausstehen.

Dieser Befehl ist erforderlich, wenn das Gerät abgefragte Ereignisse unterstützt oder das Gerät online status anzeigen soll.