EVT_WDF_WMI_PROVIDER_FUNCTION_CONTROL fonction de rappel (wdfwmi.h)

Article
02/27/2024

[S’applique uniquement à KMDF]

La fonction de rappel EvtWmiProviderFunctionControl d’un pilote active et désactive la prise en charge du pilote pour la collecte de données et l’envoi d’événements pour un fournisseur de données WMI spécifié.

Syntaxe

EVT_WDF_WMI_PROVIDER_FUNCTION_CONTROL EvtWdfWmiProviderFunctionControl;

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

Paramètres

[in] WmiProvider

Handle d’un objet de fournisseur WMI.

[in] Control

Valeur de type WDF_WMI_PROVIDER_CONTROL qui identifie une fonctionnalité que le pilote doit activer ou désactiver.

[in] Enable

Valeur booléenne qui, si TRUE, indique que le pilote doit activer la fonctionnalité spécifiée par Control . Si la valeur est FALSE, le pilote doit désactiver la fonctionnalité.

Valeur retournée

La fonction de rappel EvtWmiProviderFunctionControl doit retourner STATUS_SUCCESS si l’opération réussit. Sinon, il doit retourner une valeur status pour laquelle NT_SUCCESS(status) est false.

Remarques

Pour inscrire une fonction de rappel EvtWmiProviderFunctionControl , votre pilote doit placer l’adresse de la fonction dans une structure WDF_WMI_PROVIDER_CONFIG avant d’appeler WdfWmiProviderCreate.

Si votre pilote définit l’indicateur WdfWmiProviderExpensive dans le membre Flags de la structure de WDF_WMI_PROVIDER_CONFIG d’un fournisseur de données WMI, et si le pilote fournit une fonction de rappel EvtWmiProviderFunctionControl , l’infrastructure appelle la fonction de rappel lorsque le pilote doit activer ou désactiver sa capacité à collecter des données WMI.

Au lieu de fournir une fonction de rappel EvtWmiProviderFunctionControl , le pilote peut appeler WdfWmiProviderIsEnabled pour savoir s’il doit activer ou désactiver la collecte de données.

Pour plus d’informations sur la fonction de rappel EvtWmiProviderFunctionControl , consultez Prise en charge de WMI dans les pilotes Framework-Based.