Fonction de rappel ETWENABLECALLBACK (wdm.h)

La fonction EtwEnableCallback est une fonction de rappel fournie par le pilote facultative qui est utilisée pour recevoir des notifications d’activation ou de désactivation.

Syntaxe

ETWENABLECALLBACK Etwenablecallback;

void Etwenablecallback(
  [in]                LPCGUID SourceId,
                      ULONG ControlCode,
  [in]                UCHAR Level,
  [in]                ULONGLONG MatchAnyKeyword,
  [in]                ULONGLONG MatchAllKeyword,
  [in, optional]      PEVENT_FILTER_DESCRIPTOR FilterData,
  [in, out, optional] PVOID CallbackContext
)
{...}

Paramètres

[in] SourceId

GUID qui identifie la session qui a activé le fournisseur.

ControlCode

[in] Level

Niveau auquel l’événement est activé. Ce paramètre est une valeur définie par le fournisseur qui spécifie la détail des événements que le fournisseur écrit. Le fournisseur doit écrire l’événement si cette valeur est inférieure ou égale à la valeur de niveau définie par l’événement.

Cette valeur est transmise dans le paramètre Level de la fonction EnableTraceEx ou le paramètre EnableLevel de la fonction EnableTrace .

[in] MatchAnyKeyword

Masque de bits des mots clés que le fournisseur utilise pour déterminer la catégorie d’événements qu’il écrit.

Cette valeur est transmise dans le paramètre MatchAnyKeyword de la fonction EnableTraceEx ou le paramètre EnableFlag de la fonction EnableTrace . MatchAnyKeyword est une valeur 64 bits et est essentiellement une version étendue de l’enableFlag 32 bits.

[in] MatchAllKeyword

Ce masque de bits limite également la catégorie d’événements que le fournisseur écrit.

Cette valeur est transmise dans le paramètre MatchAllKeywords de la fonction EnableTraceEx .

[in, optional] FilterData

Données définies par le fournisseur. Ce paramètre est facultatif. Le fournisseur détermine la disposition des données et son objectif. Par exemple, le fournisseur peut utiliser ces données pour filtrer les événements qu’il écrit ou l’utiliser pour effectuer certains calculs avant d’écrire les événements. Pour plus d’informations, consultez le descripteur de filtre d’événements.

[in, out, optional] CallbackContext

Contexte de la fonction de rappel définie lorsque le fournisseur appelé EtwRegister doit s’inscrire lui-même. Ce paramètre est facultatif.

Valeur renvoyée

None

Remarques

Utilisez la fonction EtwRegister pour spécifier un pointeur vers la fonction EtwEnableCallback .

Utilisez le paramètre FilterData de la fonction de rappel pour fournir au fournisseur des capacités de filtrage sophistiquées. La fonction EtwEnableCallback ne remplace pas les appels de fonction enable-status (EtwEventEnabled et EtwProviderEnabled). Toutefois, il sert de supplément à eux. Toutefois, sauf si votre niveau et vos mots clés sont actuellement activés, l’événement n’est pas écrit, quel que soit le FiltreData fourni par la fonction de rappel.

Les appelants d’EtwEnableCallback doivent s’exécuter à IRQL = PASSIVE_LEVEL dans le contexte d’un thread système.

Configuration requise

   
Client minimal pris en charge Disponible dans Windows Vista et versions ultérieures de Windows.
Plateforme cible Desktop (Expérience utilisateur)
En-tête wdm.h (include Wdm.h, Ntddk.h)
IRQL PASSIVE_LEVEL

Voir aussi

EnableTrace

EnableTraceEx

EtwEventEnabled

EtwProviderEnabled

EtwRegister

Descripteur de filtre d’événements