Extensões da folha de propriedades
O item de menu de contexto Propriedades fornece acesso a folhas de propriedades do scanner ou da câmera na pasta Scanners e Câmeras Painel de Controle para dispositivos (itens raiz) ou na pasta Meu Computador.
Extensões de folha de propriedades para câmeras e scanners também podem fornecer uma interface do usuário para sessões de aquisição de imagem específicas, ou seja, objetos IWiaItem não raiz (consulte a documentação do SDK do Microsoft Windows), que estão ativos quando o usuário está usando a caixa de diálogo de verificação padrão. Essas extensões são acessadas por meio de um link de propriedades avançadas ou configurações avançadas na caixa de diálogo de aquisição de imagem. Quando uma ação é escolhida no menu de contexto de uma propriedade, o WIA constrói a folha de propriedades usando a implementação fornecida pelo fornecedor das interfaces IShellExtInit e IShellPropSheetExt (consulte a documentação do SDK do Windows).
Para extensões de interface do usuário do menu de contexto e folha de propriedades, a interface IDataObject (descrita na documentação do SDK do Windows) que descreve os itens selecionados usa o formato WIAItemNames ou o formato WIAItemPointer. Esses formatos e seus nomes de formato são definidos em wiadevd.h.
O formato WIAItemNames, cujo nome de formato é CFSTR_WIAITEMNAMES, retorna um HGLOBAL apontando para uma lista terminada em nulo duplo de identificadores IWiaItem . Cada identificador é do nome> do caminho id>::<full do dispositivo de formulário<. Para itens raiz, a parte do nome do caminho completo está vazia.
O formato WIAItemPointer tem suporte em versões do Microsoft Windows XP e posteriores. O nome do formato é CFSTR_WIAITEMPTR. O formato WIAItemPointer retorna uma estrutura STGMEDIUM (declarada na documentação do SDK do Windows) cujo membro tymed está definido como TYMED_ISTREAM. Esse formato pode ser usado quando o usuário seleciona apenas um único item. A folha de propriedades ou a extensão de contexto pode chamar CoUnmarshalInterface no objeto IStream armazenado na estrutura STGMEDIUM para recuperar uma interface IWiaItem . (Consulte a documentação do SDK do Windows para obter descrições da função CoUnmarshalInterface e das interfaces IStream e IWiaItem .) Usando esse formato, cada página na folha de propriedades pode compartilhar uma interface IWiaItem com marshaling adequado, o que é importante durante as verificações.