WIA_DPS_SCAN_AVAILABLE_ITEM
A propriedade WIA_DPS_SCAN_AVAILABLE_ITEM fornece o nome da origem de entrada para uma operação de verificação por push que o aplicativo executa sob controle de programa. O minidriver WIA cria e mantém essa propriedade.
Tipo de propriedade: VT_BSTR
Valores válidos: WIA_PROP_NONE
Direitos de acesso: somente leitura
Comentários
No Windows 7 e posterior, WIA_DPS_SCAN_AVAILABLE_ITEM é uma propriedade opcional do item raiz na árvore de itens WIA de um dispositivo de scanner WIA. Um aplicativo pode consultar essa propriedade para determinar a origem de entrada (flatbed, alimentador automático de documentos ou adaptador de verificação de filme) para verificar ou o local de armazenamento do qual transferir dados.
Alguns dispositivos de scanner WIA permitem que um usuário selecione uma fonte de entrada para um trabalho de verificação no painel frontal do dispositivo ou selecione implicitamente uma fonte de entrada, por exemplo, inserindo um documento em um alimentador no dispositivo. Quando o usuário pressiona o botão iniciar verificação no dispositivo, o aplicativo deve determinar qual fonte de entrada o usuário selecionou para que possa iniciar uma operação de verificação nessa origem.
Um evento de verificação notifica o aplicativo de que o usuário iniciou uma verificação, mas o evento não fornece o nome do item WIA que representa a origem de entrada. O manipulador de eventos do aplicativo pode consultar a propriedade WIA_DPS_SCAN_AVAILABLE_ITEM do item raiz para obter o nome do item de origem de entrada.
O item raiz em uma árvore WIA tem um ou mais itens filho (item de flatbed, item do alimentador e item de filme) que representam fontes de entrada no dispositivo. Cada um desses itens pode ser pai de itens filho que representam partes ou regiões da origem de entrada. Um item de flatbed que é filho do item raiz e que representa o flatbed como um todo pode ter filhos (que também são itens de flatbed) que representam as regiões individuais da superfície de flatbed. Um item do alimentador que é filho do item raiz e que representa um alimentador automático de documentos pode ter filhos que representam os scanners para os lados frontal e traseiro das páginas do documento que passam pelo alimentador. Um item de filme que é filho do item raiz e que representa o adaptador de varredura de filme como um todo pode ter filhos (que também são itens de filme) que representam quadros de filme individuais. Dependendo da operação de verificação solicitada pelo usuário, a propriedade WIA_DPS_SCAN_AVAILABLE_ITEM pode nomear um item de plano, alimentador ou filme que seja filho da raiz ou pode nomear um filho de um desses itens. Para obter mais informações sobre esses itens, consulte Categorias de itens WIA.
Quando ocorre um evento de verificação, o driver define imediatamente o valor da propriedade WIA_DPS_SCAN_AVAILABLE_ITEM como um nome de item WIA (exatamente como relatado pela propriedade WIA_IPA_ITEM_NAME do item) que identifica a origem de entrada da qual o trabalho de verificação está disponível, se essas informações forem conhecidas. Caso contrário, se a fonte de entrada for desconhecida, o driver definirá o valor da propriedade como uma cadeia de caracteres vazia. Quando o aplicativo consome o evento de verificação, o estado do evento de verificação muda de sinalizado para não sinalizado e o driver redefine o valor da propriedade WIA_DPS_SCAN_AVAILABLE_ITEM para uma cadeia de caracteres vazia.
Para obter mais informações sobre essa propriedade, consulte Identificando a fonte de entrada para um evento de verificação.
Requisitos
Cabeçalho: wiadef.h (inclua Wiadef.h)