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
WDF_WMI_INSTANCE_CONFIG_INIT_PROVIDER