EVENT_HEADER_EXTENDED_DATA_ITEM Struktur (evntcons.h)

Definiert die erweiterten Daten, die die Ereignisablaufverfolgung für Windows (ETW) als Teil der Ereignisdaten sammelt.

Syntax

typedef struct _EVENT_HEADER_EXTENDED_DATA_ITEM {
  USHORT    Reserved1;
  USHORT    ExtType;
  struct {
    USHORT Linkage : 1;
    USHORT Reserved2 : 15;
  };
  USHORT    DataSize;
  ULONGLONG DataPtr;
} EVENT_HEADER_EXTENDED_DATA_ITEM, *PEVENT_HEADER_EXTENDED_DATA_ITEM;

Angehörige

Reserved1

Reserviert.

ExtType

Der Typ der erweiterten Daten. Die folgenden Beispiele sind einige mögliche Werte.

Wert	Bedeutung
EVENT_HEADER_EXT_TYPE_EVENT_KEY	Der DataPtr Member verweist auf eine EVENT_EXTENDED_ITEM_EVENT_KEY Struktur, die einen eindeutigen Ereignisbezeichner enthält, der eine 64-Bit-Skalare ist. Die EnableProperty- EVENT_ENABLE_PROPERTY_EVENT_KEY muss für den EnableTrace- aufruf für einen bestimmten Anbieter übergeben werden, um dieses Feature zu aktivieren.
EVENT_HEADER_EXT_TYPE_EVENT_SCHEMA_TL	Der DataPtr Member verweist auf ein erweitertes Headerelement, das Metadateninformationen zum TraceLogging-Ereignis enthält.
EVENT_HEADER_EXT_TYPE_INSTANCE_INFO	Der DataPtr Member verweist auf eine EVENT_EXTENDED_ITEM_INSTANCE Struktur, die den Aktivitätsbezeichner enthält, wenn Sie TraceEventInstance- aufgerufen haben, um das Ereignis zu schreiben.
EVENT_HEADER_EXT_TYPE_PMC_COUNTERS	Der DataPtr Member verweist auf eine EVENT_EXTENDED_ITEM_PMC_COUNTERS Struktur, die die aktuellen PMC-Zählerwerte enthält. Um dieses Feature zu aktivieren, müssen die gültigen PMC-Zähler für die CPU über TraceSetInformationfestgelegt werden, wobei gültige Source- Werte gefunden werden, die durch Aufrufen TraceQueryInformation mit TraceProfileSourceListInfogefunden werden.
EVENT_HEADER_EXT_TYPE_PROCESS_START_KEY	Der DataPtr Member verweist auf eine EVENT_EXTENDED_ITEM_PROCESS_START_KEY Struktur, die einen eindeutigen Prozessbezeichner enthält (eindeutig in der Startsitzung). Dieser Bezeichner ist ein 64-Bit-Skalar. Die EnableProperty- EVENT_ENABLE_PROPERTY_PROCESS_START_KEY muss für den EnableTrace- aufruf für einen bestimmten Anbieter übergeben werden, um dieses Feature zu aktivieren.
EVENT_HEADER_EXT_TYPE_PROV_TRAITS	Der DataPtr Member verweist auf ein erweitertes Kopfzeilenelement, das Anbietereigenschaftendaten enthält, z. B. Eigenschaften, die über EventSetInformation(EventProviderSetTraits) oder durch EVENT_DATA_DESCRIPTOR_TYPE_PROVIDER_METADATAangegeben werden.
EVENT_HEADER_EXT_TYPE_RELATED_ACTIVITYID	Der DataPtr Member verweist auf eine EVENT_EXTENDED_ITEM_RELATED_ACTIVITYID Struktur, die den zugehörigen Aktivitätsbezeichner enthält, wenn Sie EventWriteTransfer- aufgerufen haben, um das Ereignis zu schreiben.
EVENT_HEADER_EXT_TYPE_SID	Der DataPtr Member verweist auf eine SID- Struktur, die die Sicherheits-ID (SID) des Benutzers enthält, der das Ereignis protokolliert hat. ETW enthält die SID, wenn Sie den parameter EnableProperty von EnableTraceEx auf EVENT_ENABLE_PROPERTY_SID festlegen.
EVENT_HEADER_EXT_TYPE_STACK_TRACE32	Der DataPtr Member verweist auf eine EVENT_EXTENDED_ITEM_STACK_TRACE32 Struktur, die den Aufrufstapel enthält, wenn das Ereignis auf einem 32-Bit-Computer erfasst wird.
EVENT_HEADER_EXT_TYPE_STACK_TRACE64	Der DataPtr Member verweist auf eine EVENT_EXTENDED_ITEM_STACK_TRACE64 Struktur, die den Aufrufstapel enthält, wenn das Ereignis auf einem 64-Bit-Computer erfasst wird.
EVENT_HEADER_EXT_TYPE_TS_ID	Der DataPtr Member verweist auf eine EVENT_EXTENDED_ITEM_TS_ID Struktur, die den Terminalsitzungsbezeichner enthält. ETW enthält den Terminalsitzungsbezeichner, wenn Sie den EnableProperty Parameter von EnableTraceEx- auf EVENT_ENABLE_PROPERTY_TS_ID festlegen.

Linkage

Reserviert.

Reserved2

Reserviert.

DataSize

Größe der erweiterten Daten in Bytes, auf die DataPtr verweist.

DataPtr

Zeiger auf die erweiterten Daten. Das ExtType Member bestimmt den Typ der erweiterten Daten, auf die dieses Element verweist.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Windows Vista [nur Desktop-Apps]
mindestens unterstützte Server-	Windows Server 2008 [Nur Desktop-Apps]
Header-	evntcons.h (include Evntcons.h)

Siehe auch

EVENT_RECORD