Fonction de rappel WMIDPREQUEST (evntrace.h)

Article
02/26/2024

Un fournisseur d’événements basé sur RegisterTraceGuids (« Classique ») implémente cette fonction pour recevoir ou désactiver les demandes de notification des contrôleurs.

Le type WMIDPREQUEST définit un pointeur vers cette fonction de rappel. ControlCallback est un espace réservé pour le nom de la fonction définie par l’application.

Syntaxe

WMIDPREQUEST Wmidprequest;

ULONG Wmidprequest(
  [in] WMIDPREQUESTCODE RequestCode,
       PVOID RequestContext,
       ULONG *BufferSize,
  [in] PVOID Buffer
)
{...}

Paramètres

[in] RequestCode

Code de demande. Il s’agit de l’une des valeurs suivantes.

Valeur	Signification
WMI_ENABLE_EVENTS	Active le fournisseur ou modifie la configuration du fournisseur.
WMI_DISABLE_EVENTS	Désactive le fournisseur.

RequestContext

Contexte défini par le fournisseur. Le fournisseur utilise le paramètre RequestContext de
RegisterTraceGuids pour spécifier le contexte.

BufferSize

Réservé à un usage interne.

[in] Buffer

Pointeur vers une structure de WNODE_HEADER qui contient des informations sur la session de suivi d’événements pour laquelle le fournisseur est activé ou désactivé.

Valeur retournée

Vous devez retourner ERROR_SUCCESS si le rappel réussit. Notez qu’ETW ignore la valeur de retour de cette fonction, sauf lorsqu’un contrôleur appelle EnableTrace pour activer un fournisseur et que le fournisseur n’a pas encore appelé RegisterTraceGuids. Dans ce cas, RegisterTraceGuids retourne la valeur de retour de ce rappel si l’inscription a réussi.

Remarques

Cette fonction est spécifiée à l’aide de la fonction RegisterTraceGuids . Lorsque le contrôleur appelle la fonction EnableTrace pour activer, désactiver ou modifier les indicateurs d’activation ou le niveau, ETW appelle ce rappel. Le fournisseur s’active ou se désactive en fonction de la valeur RequestCode . En règle générale, le fournisseur utilise cette valeur pour définir un indicateur global afin d’indiquer son état activé.

Le fournisseur définit son interprétation de l’activation ou de la désactivation. En règle générale, si un fournisseur est activé, il génère des événements, mais bien qu’il soit désactivé, il ne le fait pas.

ETW ne passe pas les indicateurs d’activation et le niveau d’activation que le contrôleur passe à la fonction EnableTrace à ce rappel. Pour récupérer ces informations, appelez les fonctions GetTraceEnableFlags et GetTraceEnableLevel , respectivement.

Vous devez également récupérer le handle de session dans ce rappel pour les appels futurs. Pour récupérer le handle de session, appelez la fonction GetTraceLoggerHandle .

Votre fonction de rappel ne doit pas appeler quoi que ce soit susceptible d’entraîner LoadLibrary (plus précisément, tout ce qui nécessite un verrou du chargeur).

Exemples

Pour obtenir un exemple d’implémentation d’une fonction ControlCallback , consultez Écriture d’événements classiques.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 2000 Professionnel [applications de bureau \| Applications UWP]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau \| Applications UWP]
Plateforme cible	Windows
En-tête	evntrace.h