EVT_WDF_WMI_PROVIDER_FUNCTION_CONTROL função de retorno de chamada (wdfwmi.h)

Artigo
02/27/2024

[Aplica-se somente ao KMDF]

A função de retorno de chamada EvtWmiProviderFunctionControl de um driver habilita e desabilita o suporte do driver para coletar dados e enviar eventos para um provedor de dados WMI especificado.

Sintaxe

EVT_WDF_WMI_PROVIDER_FUNCTION_CONTROL EvtWdfWmiProviderFunctionControl;

NTSTATUS EvtWdfWmiProviderFunctionControl(
  [in] WDFWMIPROVIDER WmiProvider,
  [in] WDF_WMI_PROVIDER_CONTROL Control,
  [in] BOOLEAN Enable
)
{...}

Parâmetros

[in] WmiProvider

Um identificador para um objeto de provedor WMI.

[in] Control

Um valor de tipo WDF_WMI_PROVIDER_CONTROL que identifica uma funcionalidade que o driver deve habilitar ou desabilitar.

[in] Enable

Um valor booliano que, se TRUE, indica que o driver deve habilitar a funcionalidade especificada por Control . Se FALSE, o driver deverá desabilitar a funcionalidade.

Retornar valor

A função de retorno de chamada EvtWmiProviderFunctionControl deverá retornar STATUS_SUCCESS se a operação for bem-sucedida. Caso contrário, ele deverá retornar um valor status para o qual NT_SUCCESS(status) é igual a FALSE.

Comentários

Para registrar uma função de retorno de chamada EvtWmiProviderFunctionControl , o driver deve colocar o endereço da função em uma estrutura WDF_WMI_PROVIDER_CONFIG antes de chamar WdfWmiProviderCreate.

Se o driver definir o sinalizador WdfWmiProviderExpensive no membro Flags da estrutura WDF_WMI_PROVIDER_CONFIG de um provedor de dados WMI e se o driver fornecer uma função de retorno de chamada EvtWmiProviderFunctionControl , a estrutura chamará a função de retorno de chamada quando o driver deve habilitar ou desabilitar sua capacidade de coletar dados WMI.

Em vez de fornecer uma função de retorno de chamada EvtWmiProviderFunctionControl , o driver pode chamar WdfWmiProviderIsEnabled para descobrir se deve habilitar ou desabilitar a coleta de dados.

Para obter mais informações sobre a função de retorno de chamada EvtWmiProviderFunctionControl , consulte Supporting WMI in Framework-Based Drivers.