Event Commands

Os comandos nesta seção são usados pelo microdriver para suporte a eventos de dispositivo.

CMD_GET_INTERRUPT_EVENT

Chamado pelo Driver de Flatbed wia em um thread separado para monitorar o status de eventos de botão que usam interrupções do dispositivo (ou seja, para dispositivos USB que relatam eventos por meio do pipe de interrupção). Se o dispositivo der suporte apenas à sondagem, esse comando não precisará ser implementado e E_NOTIMPL deverá ser retornado.

Dois identificadores de evento são passados para o 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. Se nenhum botão tiver sido pressionado, ele deverá ser definido como GUID_NULL.

CMD_STI_GETSTATUS

Chamado pelo Driver de Flatbed wia para obter o status online do dispositivo e, se o dispositivo tiver botões de push, para obter o status do botão.

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. Isso sinaliza que não há eventos pendentes.

Esse comando será necessário se o dispositivo der suporte a eventos sondados ou se você quiser que o dispositivo exiba o status on-line.