ETW_OPEN_TRACE_OPTIONS-Struktur (evntrace.h)

Stellt Konfigurationsparameter für die Funktionen OpenTraceFromBufferStream, OpenTraceFromFile, OpenTraceFromRealTimeLogger, OpenTraceFromRealTimeLoggerWithAllocationOptions bereit .

Syntax

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;

Member

ProcessTraceModes

Eine Bitfeldenume, die weitere Konfigurationen für die Verarbeitungssitzungen bereitstellt. Aktuell unterstützte Werte:

• ETW_PROCESS_TRACE_MODE_NONE
• ETW_PROCESS_TRACE_MODE_RAW_TIMESTAMP: Zeitstempel in der EVENT_RECORD, die für EventCallback bereitgestellt werden, werden standardmäßig nicht in die Dateizeit konvertiert. Stattdessen verbleiben sie im Uhrtyp des ursprünglichen Ereignisses (z. B. QueryPerformanceCounter, CPU-Zeitstempelzähler oder GetSystemTimeAsFileTime).

EventCallback

Funktionszeiger vom Typ PEVENT_RECORD_CALLBACK. Wird für jedes Ereignis in der Zeitreihenfolge aufgerufen. Wenn NULL, wird die gesamte Verarbeitung der Ereigniswiedergabe umgangen, um die Leistung zu verbessern.

EventCallbackContext

Benutzerdefinierter Kontext, der in EVENT_RECORD verfügbar sein wird. UserContext innerhalb von EventCallback.

BufferCallback

Wird für jeden Puffer aufgerufen, sobald die Verarbeitung für diesen Puffer abgeschlossen ist. Wenn NULL, wird kein Pufferrückruf ausgeführt.

BufferCallbackContext

Benutzerdefinierter Kontext, der als CallbackContext-Parameter an bufferCallback übergeben wird.

Anforderungen

Unterstützte Mindestversion (Client)	Windows 2000 Professional [Desktop-Apps | UWP-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [Desktop-Apps | UWP-Apps]
Kopfzeile	evntrace.h