Introdução ao WMI para drivers KMDF

[Aplica-se apenas ao KMDF]

Kernel-Mode Driver Framework oferece suporte a drivers que fornecem informações para WMI (Instrumentação de Gerenciamento do Windows). Esses drivers são chamados de provedores de dados WMI porque fornecem dados para clientes WMI, que são aplicativos que se registraram para receber informações do WMI.

Os provedores de dados WMI suportam blocos de dados WMI, que podem representar um ou mais dos seguintes itens:

• Itens de dados, que contêm dados específicos do dispositivo que um driver envia ou recebe de um cliente WMI.

• Métodos (funções) que o driver executa em nome de um cliente WMI.

• Eventos que o driver envia para clientes WMI que se registraram para receber notificações de eventos específicos do dispositivo.

Os blocos de dados WMI são especificados como classes WMI em arquivos .mof. Cada bloco de dados WMI é identificado por um GUID.

Todos os drivers devem suportar quaisquer blocos de dados WMI padrão que o WMI define para sua classe de dispositivo. Esses blocos de dados WMI são definidos em Wmicore.mof.

Seu driver também pode suportar blocos de dados WMI que você define em um arquivo .mof. Para saber como definir e publicar blocos de dados WMI personalizados, consulte as seguintes seções:

• Sintaxe MOF para dados WMI e blocos de eventos

• Projetando blocos de dados e eventos WMI

• Publicando um esquema WMI

• Folhas de propriedades WMI

Estrutura de Objetos WMI e Funções de Retorno de Chamada

A estrutura define dois objetos que os drivers podem usar para implementar provedores de dados WMI. O objeto do fornecedor WMI representa o esquema dos blocos de dados WMI que o driver fornece. O objeto de instância WMI representa uma instância de um bloco de dados associado a um provedor específico. Os drivers comunicam-se com clientes WMI implementando as seguintes funções de retorno de chamada de evento que são definidas por esses dois objetos:

EvtWmiProviderFunctionControl
Habilita e desabilita o suporte do driver para coletar dados WMI e enviar eventos WMI.

EvtWmiInstanceQueryInstance
Fornece os dados de instância de um provedor WMI para um cliente WMI.

EvtWmiInstanceSetInstance e EvtWmiInstanceSetItem
Defina as informações no bloco de dados de um driver para valores fornecidos pelo cliente.

EvtWmiInstanceExecuteMethod
Executa um método fornecido pelo driver, a pedido de um cliente.

Drivers de exemplo que implementam WMI

Os drivers de exemplo FIREFLY, PCIDRV e Toaster são provedores de dados WMI.