função WDF_WMI_INSTANCE_CONFIG_INIT_PROVIDER (wdfwmi.h)

Artigo
02/07/2025

[Aplica-se somente ao KMDF]

A função WDF_WMI_INSTANCE_CONFIG_INIT_PROVIDER inicializa uma estrutura de WDF_WMI_INSTANCE_CONFIG e armazena um identificador especificado em um objeto de provedor WMI.

Sintaxe

void WDF_WMI_INSTANCE_CONFIG_INIT_PROVIDER(
  [out] PWDF_WMI_INSTANCE_CONFIG Config,
  [in]  WDFWMIPROVIDER           Provider
);

Parâmetros

[out] Config

Um ponteiro para uma estrutura WDF_WMI_INSTANCE_CONFIG.

[in] Provider

Um identificador para um objeto de provedor WMI que o driver obteve por uma chamada anterior para WdfWmiProviderCreate.

Valor de retorno

Nenhum

Observações

A função WDF_WMI_INSTANCE_CONFIG_INIT_PROVIDER zera a estrutura de WDF_WMI_INSTANCE_CONFIG especificada pelo parâmetro de Configuração e define seu membro Size. Essa função também define o membro provedor de da estrutura para o identificador especificado pelo parâmetro provedor de.

O driver deve chamar WDF_WMI_INSTANCE_CONFIG_INIT_PROVIDER para inicializar uma estrutura de WDF_WMI_INSTANCE_CONFIG se ele chamar WdfWmiProviderCreate antes de chamar WdfWmiInstanceCreate.

Exemplos

O exemplo de código a seguir inicializa uma estrutura de WDF_WMI_PROVIDER_CONFIG e chama WdfWmiProviderCreate. Em seguida, o exemplo inicializa uma estrutura de WDF_WMI_INSTANCE_CONFIG e chama WdfWmiInstanceCreate.

WDF_WMI_PROVIDER_CONFIG  providerConfig;
WDFWMIPROVIDER  provider;
GUID  providerGuid = MY_WMI_DATA_BLOCK_GUID;
WDF_WMI_INSTANCE_CONFIG  instanceConfig;
WDFWMIINSTANCE  instanceHandle;
NTSTATUS  status;

WDF_WMI_PROVIDER_CONFIG_INIT(
                             &providerConfig,
                             providerGuid
                             );
providerConfig.Flags = WdfWmiProviderTracing;
providerConfig.EvtWmiProviderFunctionControl = MyProviderFunctionControl;

status = WdfWmiProviderCreate(
                              Device,
                              &providerConfig,
                              WDF_NO_OBJECT_ATTRIBUTES,
                              &provider
                              );

if (!NT_SUCCESS(status)) {
    return status;
}
WDF_WMI_INSTANCE_CONFIG_INIT_PROVIDER(
                                      &instanceConfig,
                                      provider
                                      );
status = WdfWmiInstanceCreate(
                              Device,
                              &instanceConfig,
                              WDF_NO_OBJECT_ATTRIBUTES,
                              &instanceHandle
                              );
if (!NT_SUCCESS(status)) {
    return status;
}