Categorias de item WIA

Este tópico se aplica ao Windows Vista e posterior.

Todos os itens em uma árvore de itens WIA devem dar suporte à propriedade WIA_IPA_ITEM_CATEGORY . Essa propriedade identifica a categoria funcional à qual um item pertence. A categoria determina o conjunto de sinalizadores de item WIA e propriedades WIA associadas ao item.

O WIA define as seguintes categorias de itens:

WIA_CATEGORY_ROOT
O item raiz na árvore de itens de um dispositivo de scanner WIA representa o dispositivo como um todo. Se o dispositivo incluir uma função de varredura flatbed, ADF ou film, os itens que representam essas fontes de entrada serão filhos do item raiz. Se o dispositivo contiver armazenamento, o item de pasta superior na hierarquia de armazenamento do dispositivo será um filho do item raiz. Um aplicativo pode acessar informações sobre o dispositivo, incluindo status, identificação e direitos de acesso, por meio das propriedades WIA implementadas no item raiz. Para obter mais informações, consulte as discussões sobre as propriedades do item raiz em Implementando árvores de itens de scanner de base, implementando árvores de itens do verificador do alimentador e implementando árvores de itens do verificador de filme.

WIA_CATEGORY_FLATBED
Um item de flatbed representa um flatbed de varredura (também chamado de platen de verificação) em um dispositivo de scanner WIA. A árvore de itens WIA para um dispositivo com um flatbed de verificação deve incluir um item de flatbed que é um filho do item raiz. Além disso, se o dispositivo WIA der suporte à segmentação (por exemplo, por um filtro de segmentação) ou à verificação de várias regiões, esse item de flatbed deverá ter filhos, que também são itens de flatbed, para representar as regiões de verificação individuais no flatbed. Os itens filho, quando presentes, devem pertencer à mesma categoria WIA_CATEGORY_FLATBED que seu pai e devem dar suporte às mesmas propriedades WIA (e ter os mesmos valores de propriedade iniciais) que seus pais, exceto que as posições e extensões dos itens filho são limitadas às regiões de verificação que eles representam. Um aplicativo pode usar o filtro de segmentação do driver WIA (se for fornecido) para criar regiões de verificação ou o minidriver pode detectar e criar automaticamente as próprias regiões de verificação. Um aplicativo pode acessar a função de verificação de flatbed do dispositivo por meio das propriedades wia implementadas no item de flatbed (ou itens). Para obter mais informações, consulte Implementando árvores de itens de scanner de flatbed.

WIA_CATEGORY_FEEDER
Um item do alimentador representa um ADF (alimentador automático de documentos) em um dispositivo de scanner WIA. (Essa categoria de item também pode representar um alimentador que não é totalmente automático e que requer assistência manual do usuário, mas, nesse caso, o minidriver WIA é responsável por verificar se a próxima página do documento avançou por meio do alimentador antes de examinar a página.) Um dispositivo com um ADF deve incluir um item do alimentador em sua árvore de itens WIA. Um item do alimentador é um filho do item raiz. Um aplicativo pode acessar a função de verificação do ADF do dispositivo por meio das propriedades wia implementadas no item do alimentador. Para obter mais informações, consulte Implementando árvores de itens do verificador do alimentador.

Se o ADF puder executar a verificação duplex (ou seja, examinar ambos os lados de uma página de documento) e oferecer suporte a diferentes configurações de controle para verificar os lados frontal e traseiro das páginas do documento, o minidriver WIA deverá implementar um item frontal do alimentador e um item de fundo do alimentador como filhos do item do alimentador. Um aplicativo pode acessar as funções de verificação frontal e traseira do ADF por meio das propriedades wia implementadas no item frontal do alimentador e no item de fundo do alimentador. Para obter mais informações sobre esses dois itens, consulte as descrições de categoria a seguir.

WIA_CATEGORY_FEEDER_FRONT
Um item frontal do alimentador representa as configurações do ADF para verificar o lado frontal das páginas em um documento. Esse item deve ser implementado pelo minidriver WIA para um dispositivo de scanner que tem um ADF que pode executar a verificação duplex e que dá suporte a diferentes configurações de controle para verificar os lados frontal e traseiro das páginas do documento. Um dispositivo que tem um ADF que sempre usa as mesmas configurações para ambos os lados das páginas do documento não precisa desse item. Um item frontal do alimentador é filho de um item do alimentador. Um aplicativo pode acessar a função de verificação frontal do ADF por meio das propriedades wia implementadas no item frontal do alimentador. Para obter mais informações, consulte Implementando árvores de itens do verificador do alimentador.

WIA_CATEGORY_FEEDER_BACK
Um item de volta do alimentador representa as configurações do ADF para verificar o lado traseiro das páginas em um documento. Esse item deve ser implementado pelo minidriver WIA para um dispositivo de scanner que tem um ADF que pode executar a verificação duplex e que dá suporte a diferentes configurações de controle para verificar os lados frontal e traseiro das páginas do documento. Um dispositivo que tem um ADF que sempre usa as mesmas configurações para ambos os lados das páginas do documento não precisa desse item. Um item de volta do alimentador é um filho de um item do alimentador. Um aplicativo pode acessar a função de verificação de back do ADF por meio das propriedades wia implementadas no item de volta do alimentador. Para obter mais informações, consulte Implementando árvores de itens do verificador do alimentador.

WIA_CATEGORY_FILM
Um item de filme representa uma função de verificação de filme em um dispositivo de scanner WIA. Um dispositivo que é um verificador de filme dedicado ou que é um scanner de flatbed equipado com um adaptador de transparência (TPA), deve incluir um ou mais itens de filme em sua árvore de itens WIA. Um item de filme é um filho do item raiz ou de outro item de filme. Um item de filme que é filho do item raiz representa toda a superfície de varredura, e esse item de filme pode ter filhos que são itens de filme que representam as regiões da superfície de varredura que correspondem a quadros de filme individuais. Um aplicativo pode acessar a função de verificação de filme do dispositivo por meio das propriedades wia implementadas no item de filme (ou itens). Para obter mais informações, consulte Implementando árvores de itens do verificador de filme.

WIA_CATEGORY_FOLDER
Um item de pasta representa uma pasta localizada no armazenamento interno do dispositivo de scanner WIA. Um item de pasta é um filho do item raiz ou de outro item de pasta. Se um item de pasta tiver filhos, os filhos serão uma combinação de itens de arquivo concluídos e itens de pasta. O item de pasta superior em uma árvore de itens é um filho do item raiz. Um aplicativo pode acessar o conteúdo da pasta e as informações sobre a pasta por meio das propriedades wia implementadas no item de pasta. Para obter mais informações, consulte Armazenamento de scanner WIA.

WIA_CATEGORY_FINISHED_FILE
Um item de arquivo concluído representa um arquivo concluído armazenado em uma pasta em um dispositivo de scanner WIA. Um arquivo concluído é um arquivo cujo conteúdo não será alterado. Essa definição exclui arquivos cujo conteúdo pode ser alterado dinamicamente, por exemplo, à medida que o scanner adquire e processa dados de imagem. Um item de arquivo concluído é filho de um item de pasta. Um aplicativo pode acessar um arquivo concluído e informações sobre o arquivo por meio das propriedades WIA implementadas no item de arquivo concluído. Para obter mais informações, consulte Armazenamento de scanner WIA.

WIA_CATEGORY_AUTO
No Windows 7 e posterior, um item automático representa as definições de configuração automática para um dispositivo de scanner WIA que dá suporte à verificação configurada automaticamente. Esse tipo de dispositivo pode definir suas próprias configurações de verificação em vez de exigir que as configurações sejam definidas por um aplicativo WIA em execução em um computador desktop. Por exemplo, se o dispositivo permitir que o usuário inicie uma operação de verificação do dispositivo (em vez da interface do usuário do aplicativo) e selecione a origem de entrada para a operação do dispositivo, o aplicativo poderá usar o item automático para descarregar, para o dispositivo, a tarefa de configurar a fonte de entrada selecionada. Um item automático é um filho do item raiz. Uma árvore WIA que contém um item automático também deve conter um ou mais dos seguintes: item de flatbed, item do alimentador ou item de filme. Um aplicativo pode acessar a função de verificação configurada automaticamente de um dispositivo por meio das propriedades wia implementadas no item raiz e no item automático. Para obter mais informações, consulte Propriedades wia compatíveis com um item automático.

Cada categoria de item wia tem um conjunto de sinalizadores de item WIA necessários e propriedades WIA que um item na categoria deve dar suporte e, além disso, um conjunto de sinalizadores e propriedades que o item pode dar suporte como opções. Para obter um resumo dos sinalizadores e propriedades associados às várias categorias de itens, consulte WIA_IPA_ITEM_CATEGORY. Para obter uma lista completa dos sinalizadores de item WIA, consulte WIA_IPA_ITEM_FLAGS.