Compartilhar via

Adicionar propriedades WIA a um item WIA

  • Artigo

Cada item WIA contém propriedades WIA. Um aplicativo lê e grava propriedades de item WIA para configurar o minidriver WIA. O serviço WIA chama o método IWiaMiniDrv::d rvInitItemProperties uma vez para cada item acessado pelo aplicativo, para inicializar as propriedades desse item de minidriver WIA. Se um aplicativo não ler ou gravar propriedades WIA em um item, esse método não será chamado para esse item. O contexto de item para o qual o parâmetro pWiasContext aponta indica qual item será inicializado com propriedades WIA.

O método IWiaMiniDrv::d rvInitItemProperties deve executar as seguintes tarefas:

  1. Use os dados recebidos no parâmetro pWiasContext para determinar o tipo de item. O minidriver WIA pode obter a interface COM IWiaDrvItem chamando wiasGetDrvItem. Depois de obter essa interface, o método IWiaDrvItem::GetItemFlags pode ser chamado para determinar o tipo de item WIA.

  2. Crie uma matriz de nomes de propriedade e IDs de propriedade que descrevam o conjunto de propriedades completo necessário no item atual. Depois de criar essas matrizes, o minidriver WIA deve chamar a função de serviço wiasSetItemPropNames . Essa função instrui o serviço WIA a criar um conjunto de propriedades WIA com base nas matrizes criadas. Essa função sempre deve ser chamada antes de wiasWriteMultiple e wiasSetItemPropAttribs.

  3. Escreva os valores de configuração iniciais ou padrão no conjunto de propriedades WIA recém-criado. O minidriver WIA deve chamar a função de serviço wiasWriteMultiple para definir os valores iniciais. Essa função sempre deve ser chamada antes de wiasSetItemPropAttribs.

  4. Escreva os valores válidos e os direitos de acesso para cada propriedade. O minidriver WIA deve chamar a função de serviço wiasSetItemPropAttribs para definir os direitos de acesso e os valores válidos.

Os aplicativos são responsáveis pela leitura (e releitura) de todas as propriedades das quais dependem, permitindo que o aplicativo capture quaisquer alterações nos valores da propriedade. Scanners e câmeras têm um conjunto de propriedades necessárias. Essas propriedades estão listadas em Sobre as propriedades do WIA.

Algumas propriedades têm dependências de outras propriedades. Por exemplo, a propriedade format depende da propriedade tymed . Essas dependências entre propriedades são abordadas em Propriedades do WIA.