Event Commands

De opdrachten in deze sectie worden gebruikt door de microdriver voor ondersteuning van apparaatevenementen.

CMD_GET_INTERRUPT_EVENT

Aangeroepen door het WIA Flatbed Driver in een afzonderlijke thread om de status van knopgebeurtenissen te bewaken die gebruikmaken van interrupts van het apparaat (dat wil gezegd, voor USB-apparaten die gebeurtenissen via de interruptpijp rapporteren). Als uw apparaat alleen polling ondersteunt, hoeft deze opdracht niet te worden geïmplementeerd en moet E_NOTIMPL worden geretourneerd.

Er worden twee gebeurtenisingangen doorgegeven aan de microdriver. 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. Als er geen knop is ingedrukt, moet deze worden ingesteld op GUID_NULL.

CMD_STI_GETSTATUS

Wordt aangeroepen door het WIA Flatbed Driver om de onlinestatus van het apparaat op te halen en als het apparaat drukknoppen heeft, om de knopstatus op te halen.

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. Dit geeft aan dat er geen gebeurtenissen in behandeling zijn.

Deze opdracht is vereist als het apparaat polled gebeurtenissen ondersteunt of als u wilt dat het apparaat de status van de regel weergeeft.