EVENT_TRACE-Struktur (evntrace.h)
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 |