Fonction de rappel ETWENABLECALLBACK (wdm.h)
La fonction EtwEnableCallback est une fonction de rappel facultative fournie par le pilote 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 écrits par le fournisseur. 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 passée 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 la EnableFlag 32 bits.
[in] MatchAllKeyword
Ce masque de bits limite également la catégorie d’événements que le fournisseur écrit.
Cette valeur est passée 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 des calculs avant d’écrire les événements. Pour plus d’informations, consultez descripteur de filtre d’événements.
[in, out, optional] CallbackContext
Contexte de la fonction de rappel définie lorsque le fournisseur appelé EtwRegister s’inscrire. Ce paramètre est facultatif.
Valeur de retour
Aucun
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). Cependant, 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 FilterData fourni par la fonction de rappel.
Les appelants de EtwEnableCallback doivent s’exécuter à IRQL = PASSIVE_LEVEL dans le contexte d’un thread système.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Disponible dans Windows Vista et versions ultérieures de Windows. |
| plateforme cible | Bureau |
| d’en-tête | wdm.h (include Wdm.h, Ntddk.h) |
| IRQL | PASSIVE_LEVEL |