Identificando a fonte de entrada para um evento de verificação
Uma operação de verificação por push é uma operação de verificação que o usuário inicia de um dispositivo de scanner WIA em vez da interface do usuário de um aplicativo WIA em execução em um computador desktop. Quando o usuário pressiona o botão iniciar verificação no dispositivo, o aplicativo recebe um evento de verificação para notificá-lo de que o usuário solicitou uma operação de verificação. Em resposta a esse evento, o aplicativo pode executar a operação de verificação por push de uma das duas seguintes maneiras:
Se o dispositivo der suporte à verificação configurada automaticamente, o aplicativo poderá solicitar uma transferência de dados do item automático para adquirir uma imagem da fonte de entrada selecionada no momento (flatbed, alimentador automático de documentos ou adaptador de verificação de filme). Em resposta, o dispositivo define automaticamente suas configurações de verificação (excluindo as poucas propriedades que só podem ser configuradas pelo aplicativo, que são descritas em Propriedades wia compatíveis com um item automático) e, em seguida, adquire a imagem.
O aplicativo pode executar a operação de verificação sob controle de programa direto. Primeiro, o aplicativo configura as propriedades do item WIA (item de flatbed, item do alimentador ou item de filme) que representa a fonte de entrada selecionada no momento. Em seguida, o aplicativo adquire uma imagem solicitando uma transferência de dados desse item.
Para obter mais informações sobre itens WIA, consulte Categorias de itens WIA.
Quando ocorre um evento de verificação, o aplicativo recebe uma notificação que inclui um identificador de evento WIA (um valor GUID) para especificar a natureza do evento. O minidriver WIA pode atribuir um GUID de identificador de evento WIA personalizado a um evento ou o minidriver pode usar uma das constantes guid do WIA_EVENT_SCAN_XXX definidas no arquivo de cabeçalho Wiadef.h. Para obter mais informações sobre essas constantes, consulte Identificadores de eventos WIA.
Embora o identificador de evento WIA para um evento de verificação forneça informações sobre o evento, ele não identifica a origem de entrada a ser usada para a operação de verificação. Para a verificação configurada automaticamente, o aplicativo não precisa dessas informações. No entanto, para executar uma verificação sob controle de programa direto, o aplicativo deve saber qual fonte de entrada usar. O aplicativo deve ter uma maneira de obter essas informações do dispositivo se o dispositivo tiver mais de uma fonte de entrada e o usuário puder selecionar a origem de entrada do dispositivo em vez de na interface do usuário do aplicativo. Ao selecionar uma fonte de entrada do dispositivo, o usuário pode selecionar a origem explicitamente (pressionando um botão no painel frontal do dispositivo) ou implicitamente (por exemplo, inserindo um documento em um alimentador no dispositivo).
Quando ocorre um evento de verificação, um aplicativo pode consultar a propriedade WIA_DPS_SCAN_AVAILABLE_ITEM do dispositivo de scanner WIA para identificar a origem de entrada selecionada, se o dispositivo der suporte a essa propriedade. WIA_DPS_SCAN_AVAILABLE_ITEM é uma propriedade opcional do item raiz na árvore de itens WIA de um dispositivo. Para obter mais informações sobre essa propriedade, consulte WIA_DPS_SCAN_AVAILABLE_ITEM.
O driver de classe de verificação WSD implementa a propriedade WIA_DPS_SCAN_AVAILABLE_ITEM como um recurso de driver padrão, conforme descrito no parágrafo anterior, em vez de como uma extensão de driver personalizada. Para obter mais informações sobre o driver de classe de verificação WSD, consulte WIA com Serviços Web para Dispositivos. Para obter mais informações sobre o WDP para scanners, consulte Web Services for Devices Scan Service Schema.