EVENT_TRACE-Struktur (evntrace.h)

  • Artikel

Die EVENT_TRACE-Struktur wird verwendet, um Ereignisinformationen an einen Ereignisablaufverfolgungsconsumer zu übermitteln.

Syntax

typedef struct _EVENT_TRACE {
  EVENT_TRACE_HEADER Header;
  ULONG              InstanceId;
  ULONG              ParentInstanceId;
  GUID               ParentGuid;
  PVOID              MofData;
  ULONG              MofLength;
  union {
    ULONG              ClientContext;
    ETW_BUFFER_CONTEXT BufferContext;
  } DUMMYUNIONNAME;
} EVENT_TRACE, *PEVENT_TRACE;

Member

Header

Eine EVENT_TRACE_HEADER-Struktur , die Standardinformationen zur Ereignisablaufverfolgung enthält.

InstanceId

Instanzbezeichner. Enthält gültige Daten, wenn der Anbieter die TraceEventInstance-Funktion aufruft , um das Ereignis zu generieren. Andernfalls ist der Wert null.

ParentInstanceId

Instanzbezeichner für ein übergeordnetes Ereignis. Enthält gültige Daten, wenn der Anbieter die TraceEventInstance-Funktion aufruft , um das Ereignis zu generieren. Andernfalls ist der Wert null.

ParentGuid

Klassen-GUID des übergeordneten Ereignisses. Enthält gültige Daten, wenn der Anbieter die TraceEventInstance-Funktion aufruft , um das Ereignis zu generieren. Andernfalls ist der Wert null.

MofData

Zeiger auf den Anfang der ereignisspezifischen Daten für dieses Ereignis.

MofLength

Anzahl der Bytes, auf die MofData verweist.

DUMMYUNIONNAME

DUMMYUNIONNAME.ClientContext

Reserviert.

DUMMYUNIONNAME.BufferContext

Stellt Informationen zum Ereignis bereit, z. B. den Sitzungsbezeichner und die Prozessornummer der CPU, auf der der Anbieterprozess ausgeführt wurde. Ausführliche Informationen finden Sie in der ETW_BUFFER_CONTEXT-Struktur .

Vor Windows Vista: Nicht unterstützt.

Hinweise

ProcessTrace übergibt diese Struktur an die EventCallback-Rückruffunktion des Consumers.

Anforderungen

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

Weitere Informationen

EventCallback