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 mesa 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 através do tubo de interrupção). Se o seu dispositivo suportar apenas sondagem, este comando não precisa de ser implementado e E_NOTIMPL deve ser devolvido.

Duas alças de evento são passadas 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 foi pressionado, ele deve ser definido como GUID_NULL.

CMD_STI_GETSTATUS

Chamado pelo WIA Flatbed Driver para obter o status on-line do dispositivo e, se o dispositivo tiver botões de pressão, 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.

Este comando é necessário se o dispositivo suportar eventos sondados ou se pretender que o dispositivo apresente o estado online.