PEVENT_TRACE_BUFFER_CALLBACKW fonction de rappel (evntrace.h)
Les consommateurs d’événements ETW implémentent cette fonction pour recevoir des statistiques sur chaque mémoire tampon d’événements qu’ETW fournit pendant une session de traitement des traces. ETW appelle cette fonction après la remise des événements de chaque mémoire tampon.
Le type PEVENT_TRACE_BUFFER_CALLBACK définit un pointeur vers cette fonction de rappel. BufferCallback est un espace réservé pour le nom de fonction défini par l’application.
Syntaxe
PEVENT_TRACE_BUFFER_CALLBACKW PeventTraceBufferCallbackw;
ULONG PeventTraceBufferCallbackw(
PEVENT_TRACE_LOGFILEW Logfile
)
{...}
Paramètres
Logfile
Pointeur vers une structure de EVENT_TRACE_LOGFILE qui contient des informations sur la mémoire tampon.
Valeur retournée
Pour continuer à traiter les événements, retournez TRUE. Sinon, retournez FALSE. Le renvoi de LA VALEUR FALSE met fin à la fonction ProcessTrace .
Remarques
Pour spécifier la fonction qu’ETW appelle pour fournir les statistiques de mémoire tampon, définissez le membre BufferCallback de la structure EVENT_TRACE_LOGFILE que vous passez à la fonction OpenTrace .
Exemples
Pour obtenir un exemple d’implémentation d’une fonction BufferCallback , consultez Récupération de données d’événement à l’aide de MOF.
Notes
L’en-tête evntrace.h définit PEVENT_TRACE_BUFFER_CALLBACK comme un alias qui sélectionne automatiquement la version ANSI ou Unicode de cette fonction en fonction de la définition de la constante de préprocesseur UNICODE. Le mélange de l’utilisation de l’alias neutre en encodage avec du code qui n’est pas neutre en encodage peut entraîner des incompatibilités qui entraînent des erreurs de compilation ou d’exécution. Pour plus d’informations, consultez Conventions pour les prototypes de fonction.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows 2000 Professionnel [applications de bureau uniquement] |
| Serveur minimal pris en charge | Windows 2000 Server [applications de bureau uniquement] |
| Plateforme cible | Windows |
| En-tête | evntrace.h |