Compartilhar via

Provedor de página de propriedade genérica WMI

  • Artigo

No Windows XP e em sistemas operacionais posteriores, os drivers podem expor suas classes WMI por meio do provedor de página de propriedades genérica 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érica 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:

  • Gravar

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

  • Valores e ValoresMap

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

  • Range

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

  • DisplayName

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

  • DisplayInHex

    Se presente, o valor da propriedade será exibido em hexadecimal.

Os gravadores de driver devem localizar qualificadores de propriedade que são cadeias de caracteres. Consulte Localizando arquivos MOF para obter detalhes.

Habilitando o provedor de página de propriedades genéricas

Cada dispositivo que expõe classes a serem usadas pelo Wmiprop.dll deve habilitar Wmiprop.dll como um co-instalador. Para fazer isso, faça a seguinte adição à seção add-registry-section do co-instalador: adicione uma entrada de valor para o GUID da classe na chave do Registro HKLM\System\CurrentControlSet\Control\CoDeviceInstallers . O valor da 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 co-instalador de classe para obter detalhes.

Você também deve especificar as classes WMI específicas a serem expostas por meio do provedor de propriedades genéricas. 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 da 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 AddReg inf 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 uma guia na folha de propriedades. Use o qualificador de propriedade DisplayName para definir o texto do título da guia. Uma página de propriedades para uma classe só será exibida se houver atualmente uma instância da classe . Portanto, se o dispositivo for removido ou não iniciado, as páginas não serão exibidas.