Fonction de rappel ETWENABLECALLBACK (wdm.h)
La fonction EtwEnableCallback est une fonction de rappel facultative fournie par le pilote 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 le niveau de 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 de mots clés que le fournisseur utilise pour déterminer la catégorie d’événements qu’il écrit.
Cette valeur est passée 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 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 leur objectif. Par exemple, le fournisseur peut utiliser ces données pour filtrer les événements qu’il écrit ou 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 a appelé EtwRegister pour s’inscrire. 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 complément à ceux-ci. Toutefois, à moins que votre niveau et vos mots clés ne soient actuellement activés, l’événement ne sera pas écrit, quelle que soit l’option FilterData que la fonction de rappel fournit.
Les appelants d’EtwEnableCallback doivent s’exécuter sur IRQL = PASSIVE_LEVEL dans le contexte d’un thread système.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Disponible dans Windows Vista et les versions plus récentes de Windows. |
| Plateforme cible | Desktop (Expérience utilisateur) |
| En-tête | wdm.h (inclure Wdm.h, Ntddk.h) |
| IRQL | PASSIVE_LEVEL |