Partager via


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

Voir aussi

EVENT_TRACE_LOGFILE

OpenTrace

ProcessTrace