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 WDF_WMI_PROVIDER_CONTROLdigitado 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 Control. Se FALSE, o driver deverá desabilitar a funcionalidade.
Valor de retorno
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 de status para o qual NT_SUCCESS(status) é igual a false.
Observações
Para registrar uma função de retorno de chamada EvtWmiProviderFunctionControl, o driver deve colocar o endereço da função em uma estrutura de WDF_WMI_PROVIDER_CONFIG antes de chamar WdfWmiProviderCreate.
Se o driver definir o sinalizador WdfWmiProviderExpensive no Flags membro da estrutura de WDF_WMI_PROVIDER_CONFIG de um provedor de dados WMI e, se o driver fornecer um EvtWmiProviderFunctionControl função de retorno de chamada, 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 em Framework-Based Drivers.
Requisitos
| Requisito | Valor |
|---|---|
| da Plataforma de Destino | Universal |
| versão mínima do KMDF | 1.0 |
| cabeçalho | wdfwmi.h (inclua Wdf.h) |
| IRQL | PASSIVE_LEVEL |