structure ETW_OPEN_TRACE_OPTIONS (evntrace.h)

Fournit des paramètres de configuration pour les fonctions OpenTraceFromBufferStream, OpenTraceFromFile, OpenTraceFromRealTimeLogger, OpenTraceFromRealTimeLoggerWithAllocationOptions .

Syntaxe

typedef struct ETW_OPEN_TRACE_OPTIONS {
  ETW_PROCESS_TRACE_MODES ProcessTraceModes;
  PEVENT_RECORD_CALLBACK  EventCallback;
  void                    *EventCallbackContext;
  PETW_BUFFER_CALLBACK    BufferCallback;
  void                    *BufferCallbackContext;
} ETW_OPEN_TRACE_OPTIONS;

Membres

ProcessTraceModes

Une énumération de champ de bits fournissant d’autres configurations pour les sessions de traitement. Valeurs actuelles prises en charge :

• ETW_PROCESS_TRACE_MODE_NONE
• ETW_PROCESS_TRACE_MODE_RAW_TIMESTAMP : les horodatages du EVENT_RECORD fournis à EventCallback ne seront pas convertis en heure de fichier, car ils sont par défaut. Au lieu de cela, ils resteront dans le type d’horloge de l’événement d’origine (par exemple, QueryPerformanceCounter, compteur d’horodatage du processeur ou GetSystemTimeAsFileTime).

EventCallback

Pointeur de fonction de type PEVENT_RECORD_CALLBACK. Appelé pour chaque événement dans l’ordre chronologique. Si la valeur est NULL, tout le traitement de la lecture d’événements sera contourné pour améliorer les performances.

EventCallbackContext

Contexte défini par l’utilisateur qui sera disponible dans EVENT_RECORD. UserContext à l’intérieur d’EventCallback.

BufferCallback

Appelé pour chaque mémoire tampon une fois le traitement sur cette mémoire tampon terminé. Si la valeur est NULL, aucun rappel de mémoire tampon n’est exécuté.

BufferCallbackContext

Contexte défini par l’utilisateur qui sera passé à BufferCallback en tant que paramètre CallbackContext.

Spécifications

Client minimal pris en charge	Windows 2000 Professionnel [applications de bureau | Applications UWP]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau | Applications UWP]
En-tête	evntrace.h