estrutura WDF_WMI_INSTANCE_CONFIG (wdfwmi.h)

[Aplica-se somente ao KMDF]

A estrutura WDF_WMI_INSTANCE_CONFIG contém informações de configuração para uma instância de um provedor de dados WMI.

Sintaxe

typedef struct _WDF_WMI_INSTANCE_CONFIG {
  ULONG                               Size;
  WDFWMIPROVIDER                      Provider;
  PWDF_WMI_PROVIDER_CONFIG            ProviderConfig;
  BOOLEAN                             UseContextForQuery;
  BOOLEAN                             Register;
  PFN_WDF_WMI_INSTANCE_QUERY_INSTANCE EvtWmiInstanceQueryInstance;
  PFN_WDF_WMI_INSTANCE_SET_INSTANCE   EvtWmiInstanceSetInstance;
  PFN_WDF_WMI_INSTANCE_SET_ITEM       EvtWmiInstanceSetItem;
  PFN_WDF_WMI_INSTANCE_EXECUTE_METHOD EvtWmiInstanceExecuteMethod;
} WDF_WMI_INSTANCE_CONFIG, *PWDF_WMI_INSTANCE_CONFIG;

Membros

Size

O tamanho, em bytes, dessa estrutura.

Provider

Um identificador para um objeto de provedor WMI que um driver obteve chamando WdfWmiProviderCreate. Se esse membro for NULL, o membro ProviderConfig não deverá ser NULL.

ProviderConfig

Um ponteiro para uma estrutura WDF_WMI_PROVIDER_CONFIG . Se esse membro for NULL, o membro Provider não deverá ser NULL.

UseContextForQuery

Um valor booliano que, se TRUE, indica que o driver armazenará dados de instância no espaço de contexto do objeto da instância WMI e não fornecerá uma função de retorno de chamada EvtWmiInstanceQueryInstance . Em vez disso, a estrutura atenderá à solicitação de um cliente WMI para dados de instância enviando o conteúdo do espaço de contexto para o WMI. Se esse membro for FALSE, o driver deverá fornecer uma função de retorno de chamada EvtWmiInstanceQueryInstance (a menos que os dados da instância sejam somente gravação).

Se UseContextForQuery for TRUE, os dados da instância deverão ser somente leitura e, portanto, o driver não poderá fornecer funções de retorno de chamada EvtWmiInstanceSetInstance ou EvtWmiInstanceSetItem .

Register

Um valor booliano que, se TRUE, indica que a estrutura registrará a instância do provedor com o serviço WMI do sistema depois de criar um objeto de instância WMI. Se esse membro for FALSE, o driver deverá chamar WdfWmiInstanceRegister para registrar a instância do provedor.

EvtWmiInstanceQueryInstance

Um ponteiro para a função de retorno de chamada EvtWmiInstanceQueryInstance do driver para a instância do provedor ou NULL.

EvtWmiInstanceSetInstance

Um ponteiro para a função de retorno de chamada EvtWmiInstanceSetInstance do driver para a instância do provedor ou NULL.

EvtWmiInstanceSetItem

Um ponteiro para a função de retorno de chamada EvtWmiInstanceSetItem do driver para a instância do provedor ou NULL.

EvtWmiInstanceExecuteMethod

Um ponteiro para a função de retorno de chamada EvtWmiInstanceExecuteMethod do driver para a instância do provedor ou NULL.

Comentários

A estrutura WDF_WMI_INSTANCE_CONFIG é usada como entrada para o método WdfWmiInstanceCreate .

Para inicializar uma estrutura de WDF_WMI_INSTANCE_CONFIG , o driver deve chamar WDF_WMI_INSTANCE_CONFIG_INIT_PROVIDER ou WDF_WMI_INSTANCE_CONFIG_INIT_PROVIDER_CONFIG.

Requisitos

Requisito	Valor
Versão mínima do KMDF	1.0
Cabeçalho	wdfwmi.h (inclua Wdf.h)

Confira também

EvtWmiInstanceExecuteMethod

EvtWmiInstanceQueryInstance

EvtWmiInstanceSetInstance

EvtWmiInstanceSetItem

WDF_WMI_INSTANCE_CONFIG_INIT_PROVIDER

WDF_WMI_INSTANCE_CONFIG_INIT_PROVIDER_CONFIG

WDF_WMI_PROVIDER_CONFIG

WdfWmiInstanceCreate

WdfWmiInstanceRegister

WdfWmiProviderCreate