PEVENT_TRACE_BUFFER_CALLBACKA 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_CALLBACKA PeventTraceBufferCallbacka;

ULONG PeventTraceBufferCallbacka(
  PEVENT_TRACE_LOGFILEA 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 .

Notes

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.

Spécifications

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