Funcionalidades do minidriver WIA

Todos os minidrivers WIA devem definir a capacidade do dispositivo de lidar com eventos e comandos de notificação. Esta seção descreve esses recursos de minidriver.

O minidriver WIA é responsável por criar uma tabela que lista todos os eventos e comandos aos quais ele dá suporte. O diagrama a seguir ilustra a tabela de funcionalidades que o minidriver WIA compila.

A tabela de funcionalidades é definida como uma matriz de estruturas de WIA_DEV_CAP_DRV . O minidriver deve construir essa matriz e devolvê-la ao serviço WIA quando o serviço WIA chamar o método IWiaMiniDrv::d rvGetCapabilities .

Definindo eventos e comandos com suporte

Os minidrivers WIA devem descrever os eventos e comandos aos quais o dispositivo dá suporte ao serviço WIA.

Eventos

Um evento é uma ação no nível do dispositivo que deve ser relatada ao driver. Por exemplo, um scanner pode ter um botão de painel frontal rotulado como "Verificação". Quando os usuários pressionam esse botão, eles esperam que o verificador inicie a verificação ou, no mínimo, que um aplicativo comece a iniciar a verificação.

O WIA dá suporte a dois tipos de eventos:

• Evento de ação: Um evento de ação inicia o aplicativo registrado para lidar com esse evento. Por exemplo, o Assistente de Scanner e Câmera da Microsoft é um manipulador registrado para o evento Scan (outros aplicativos também podem se registrar para esse evento). Quando um driver envia o evento Scan, o serviço WIA inicia o Verificador e o Assistente de Câmera para lidar com esse evento. Esse tipo de evento é frequentemente chamado de evento persistente.

• Evento de notificação: Um evento de notificação é enviado apenas para aplicativos que já estão em execução e indicaram ao serviço WIA que eles devem receber esse evento. Se o aplicativo não estiver em execução, ele não será iniciado para lidar com esse evento.

Um evento pode ser um evento de ação e um evento de notificação.

Comandos

Um comando de dispositivo WIA é uma solicitação que o serviço WIA envia (em nome do aplicativo de imagem) para o minidriver WIA que instrui o minidriver a executar alguma ação. Por exemplo, um minidriver de câmera WIA pode manipular o comando Tirar Imagem . Esse comando instrui o minidriver a ordenar que o dispositivo de câmera digital tire uma nova foto.

Observação

O Assistente de Scanner e Câmera responde imediatamente ao usuário, mesmo que ele ainda tenha limpo fazer em segundo plano. Por exemplo, a janela Verificador e Assistente de Câmera é fechada imediatamente quando o usuário solicita o cancelamento de uma ação; no entanto, o Verificador e o Assistente de Câmera têm um thread de aquisição separado que continua a ser executado após o fechamento da janela. Esse thread separado permite uma resposta imediata à solicitação do usuário, mas permite tarefas e tarefas necessárias que não podem ser interrompidas para serem concluídas sem afetar a experiência do usuário.