Event Commands

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 den Status von Schaltflächenereignissen zu überwachen, die Unterbrechungen vom Gerät verwenden (d. a. für USB-Geräte, die Ereignisse über die Interruptpipe melden). Wenn Ihr Gerät nur abruft, muss dieser Befehl nicht implementiert werden und E_NOTIMPL zurückgegeben werden.

An den Microdriver werden zwei Ereignishandles übergeben. The lVal member of the VAL structure holds an event handle that should be signaled by the microdriver using the SetEvent function when a button event occurs. The handle member of the VAL structure holds an event handle that will be signaled by the WIA Flatbed Driver when the driver is being unloaded or shut down.

The pGuid member of the VAL structure should be set to point to the GUID of the button that was pushed. Wenn keine Taste gedrückt wurde, sollte sie auf GUID_NULL festgelegt werden.

CMD_STI_GETSTATUS

Vom WIA Flatbed Driver aufgerufen, um den Onlinestatus des Geräts zu erhalten und wenn das Gerät Über Knopfdruck verfügt, um den Schaltflächenstatus zu erhalten.

Set the lVal member of the passed VAL structure to 1 if your device is online, and functioning properly. If lVal is set to any value other than 1, the device is considered offline, and it will fail the device test in Control Panel.

If the device supports buttons that do not use interrupts from the device and a button was pressed, the pGuid member of the passed VAL structure should be set to the GUID of the button event. If no buttons were pressed, point pGuid to the value GUID_NULL. Dies signalisiert, dass keine Ereignisse ausstehen.

Dieser Befehl ist erforderlich, wenn das Gerät abgefragte Ereignisse unterstützt oder das Gerät den Status "On-Line" anzeigen soll.