Partilhar via

Fornecedor de Página Genérica de Propriedades do WMI

No Windows XP e sistemas operativos posteriores, os drivers podem expor as suas classes WMI por meio do provedor de página de propriedades genéricas do WMI. O provedor usa cada declaração de classe para criar uma página de propriedades simples para as propriedades da classe.

Como os qualificadores de propriedade determinam a página de propriedades

O provedor de página de propriedades genéricas WMI usa um controle apropriado para o tipo de dados de cada propriedade na classe. Os seguintes qualificadores de propriedade modificam o tipo de controle usado:

  • Escrever

    Uma propriedade com o qualificador de gravação pode ser alterada através da página de propriedades. Caso contrário, a propriedade será somente leitura.

  • Valores e ValoresMapa

    O provedor de página de propriedades genérica usa uma caixa de listagem para representar os valores possíveis.

  • Intervalo

    O provedor de página de propriedades genéricas valida se os dados inseridos estão em conformidade com o intervalo especificado.

  • Nome_de_Visualização

    O provedor de página de propriedades genérico usa o valor desse qualificador de propriedade como o rótulo da propriedade.

  • ExibirEmHexadecimal

    Se presente, o valor da propriedade é exibido em hexadecimal.

Os programadores de drivers devem localizar qualificadores de propriedade que são strings. Consulte Localização de arquivos MOF para obter detalhes.

Ativando o provedor de página de propriedades genérica

Cada dispositivo que expõe classes a serem usadas por Wmiprop.dll deve ativar Wmiprop.dll como co-instalador. Para fazer isso, faça a seguinte adição à seção add-registry-section do coinstalador: adicione uma entrada de valor para o GUID da classe na chave do Registro HKLM\System\CurrentControlSet\Control\CoDeviceInstallers. O valor para a entrada de valor é "WmiProp.dll, WmiPropCoInstaller".

Por exemplo:

; This section is defined in the Co-installer section, as follows.
; [Co-installer]
; AddReg = CoInstaller_AddReg

[CoInstaller_AddReg] 
HKLM, System\CurrentControlSet\Control\CoDeviceInstallers, ClassGUID,
    0x00010000, "WmiProp.dll, WmiPropCoInstaller"

ClassGUID é o GUID para a classe WMI. Consulte Registrando um coinstalador de classe para obter detalhes.

Você também deve especificar as classes WMI específicas a serem expostas por meio do provedor de propriedade genérico. Para fazer isso, defina a entrada de valor WmiConfigClasses como uma lista separada por vírgulas das classes WMI na seção add-registry da classe de dispositivo ou instância de hardware do dispositivo.

; the device class AddReg section.
[device_class_AddReg]
HKR,,"WmiConfigClasses",0x00000000,"class1,class2"

; the device hardware instance AddReg section.
[device_hw_inst_AddReg]
HKR,,"WmiConfigClasses",0x00000000,"class3"

Consulte Diretiva INF AddReg para obter uma descrição de uma seção add-registry em arquivos INF.

Wmiprop.dll pressupõe apenas uma instância de cada classe. Cada classe é representada por um separador na folha de propriedades. Use o qualificador da propriedade DisplayName para definir o texto do título da guia. Uma página de propriedades para uma classe só aparece se houver atualmente uma instância da classe. Portanto, se o dispositivo for removido ou não iniciado, as páginas não aparecerão.

  • Last updated on