Provedor de página de propriedade genérica WMI

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

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

O provedor de página de propriedade 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:

• Escrever

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

• Valores e MapaValores

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

• Intervalo

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

• NomeExibicao

  O provedor de página de propriedade 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 desenvolvedores de drivers devem localizar qualificadores de propriedade que são strings. Consulte Localizando arquivos MOF para obter detalhes.

Habilitando o Provedor de Página de Propriedades Genérico

Cada dispositivo que expõe classes a serem usadas por Wmiprop.dll deve habilitar Wmiprop.dll como um co-instalador. Para fazer isso, faça a seguinte adição à seção add-registry do co-instalador: adicione uma entrada de valor para o GUID de 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 da classe WMI. Consulte Registrar 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érico. Para fazer isso, defina a entrada de valor WmiConfigClasses como uma lista separada por vírgulas das classes WMI na seção adicionar registro 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 a Diretiva AddReg INF para obter uma descrição de uma seção de adição de registro em arquivos INF.

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