Função WdfWmiProviderIsEnabled (wdfwmi.h)

  • Artigo

[Aplica-se somente ao KMDF]

O método WdfWmiProviderIsEnabled determina se a coleta de dados ou a notificação de evento está habilitada para um provedor de dados WMI especificado.

Sintaxe

BOOLEAN WdfWmiProviderIsEnabled(
  [in] WDFWMIPROVIDER           WmiProvider,
  [in] WDF_WMI_PROVIDER_CONTROL ProviderControl
);

Parâmetros

[in] WmiProvider

Um identificador para um objeto de provedor WMI que o driver obteve chamando WdfWmiProviderCreate ou WdfWmiInstanceGetProvider.

[in] ProviderControl

Um valor do tipo WDF_WMI_PROVIDER_CONTROL que especifica um dos tipos de funções de controle (coleta de dados ou notificação de evento) que um provedor de dados WMI pode dar suporte.

Retornar valor

WdfWmiProviderIsEnabled retornaráTRUE se a funcionalidade especificada pelo parâmetro ProviderControl estiver habilitada e FALSE caso contrário.

Um bug marcar ocorrerá se o driver fornecer um identificador de objeto inválido.

Comentários

Um driver que não fornece uma função de retorno de chamada EvtWmiProviderFunctionControl pode chamar WdfWmiProviderIsEnabled para determinar se a coleta de dados ou a notificação de evento está habilitada.

Exemplos

O exemplo de código a seguir determina se a notificação de evento está habilitada para um provedor de dados WMI especificado.

BOOLEAN eventNotifEnabled;

eventNotifEnabled = WdfWmiProviderIsEnabled(
                                            wmiProvider,
                                            WdfWmiEventControl
                                            );

Requisitos

Requisito Valor
Plataforma de Destino Universal
Versão mínima do KMDF 1.0
Cabeçalho wdfwmi.h (inclua Wdf.h)
Biblioteca Wdf01000.sys (consulte Controle de versão da biblioteca de estrutura.)
IRQL <=DISPATCH_LEVEL
Regras de conformidade de DDI DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

Confira também

EvtWmiProviderFunctionControl

WDF_WMI_PROVIDER_CONTROL

WdfWmiInstanceGetProvider

WdfWmiProviderCreate