Introdução ao WMI para drivers KMDF

[Aplica-se somente ao KMDF]

Kernel-Mode Driver Framework dá suporte a drivers que fornecem informações para Windows WMI (Instrumentação de Gerenciamento). 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 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 aos clientes WMI que se registraram para receber notificação 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 dar suporte a quaisquer blocos de dados WMI padrão definidos pelo WMI para sua classe de dispositivo. Esses blocos de dados WMI são definidos em Wmicore.mof.

O driver também pode dar suporte a blocos de dados WMI definidos em um arquivo .mof. Para saber como definir e publicar blocos de dados WMI personalizados, consulte as seguintes seções:

Objetos WMI de estrutura 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 de provedor WMI representa o esquema para 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 se comunicam com clientes WMI implementando as seguintes funções de retorno de chamada de evento que esses dois objetos definem:

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

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

EvtWmiInstanceSetInstancee EvtWmiInstanceSetItem
Definir informações no bloco de dados de um driver para valores fornecidos pelo cliente.

EvtWmiInstanceExecuteMethod
Executa um método fornecido pelo driver, por solicitação de um cliente.

Drivers de exemplo que implementam o WMI

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