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

[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 tipo WDF_WMI_PROVIDER_CONTROL que identifica uma funcionalidade que o driver deve habilitar ou desabilitar.

[in] Enable

Um valor booliano que, se VERDADEIRO, indica que o driver deve habilitar a funcionalidade especificada pelo Controle . Se FALSE, o driver deve desabilitar a funcionalidade.

Valor retornado

A função de retorno de chamada EvtWmiProviderFunctionControl deve retornar STATUS_SUCCESS se a operação for bem-sucedida. Caso contrário, ele deve retornar um valor de 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 de 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 ele deve habilitar ou desabilitar a coleta de dados.

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

Requisitos

   
Plataforma de Destino Universal
Versão mínima do KMDF 1,0
Cabeçalho wdfwmi.h (include Wdf.h)
IRQL PASSIVE_LEVEL

Confira também

EvtWmiInstanceExecuteMethod

EvtWmiInstanceQueryInstance

EvtWmiInstanceSetInstance

EvtWmiInstanceSetItem

WDF_WMI_PROVIDER_CONFIG

WDF_WMI_PROVIDER_CONTROL

WdfWmiProviderCreate

WdfWmiProviderIsEnabled