TRACE_EVENT_INFO-Struktur (tdh.h)

Artikel
08/26/2023

Definiert die Informationen zum Ereignis.

Syntax

typedef struct _TRACE_EVENT_INFO {
  GUID                ProviderGuid;
  GUID                EventGuid;
  EVENT_DESCRIPTOR    EventDescriptor;
  DECODING_SOURCE     DecodingSource;
  ULONG               ProviderNameOffset;
  ULONG               LevelNameOffset;
  ULONG               ChannelNameOffset;
  ULONG               KeywordsNameOffset;
  ULONG               TaskNameOffset;
  ULONG               OpcodeNameOffset;
  ULONG               EventMessageOffset;
  ULONG               ProviderMessageOffset;
  ULONG               BinaryXMLOffset;
  ULONG               BinaryXMLSize;
  union {
    ULONG EventNameOffset;
    ULONG ActivityIDNameOffset;
  };
  union {
    ULONG EventAttributesOffset;
    ULONG RelatedActivityIDNameOffset;
  };
  ULONG               PropertyCount;
  ULONG               TopLevelPropertyCount;
  union {
    TEMPLATE_FLAGS Flags;
    struct {
      ULONG Reserved : 4;
      ULONG Tags : 28;
    };
  };
  EVENT_PROPERTY_INFO EventPropertyInfoArray[ANYSIZE_ARRAY];
} TRACE_EVENT_INFO;

Member

ProviderGuid

Eine GUID, die den Anbieter identifiziert.

EventGuid

Eine GUID, die die MOF-Klasse identifiziert, die das Ereignis enthält. Wenn der Anbieter ein Manifest verwendet, um seine Ereignisse zu definieren, wird dieses Element GUID_NULL.

EventDescriptor

Eine EVENT_DESCRIPTOR-Struktur , die das Ereignis beschreibt.

DecodingSource

Ein DECODING_SOURCE Enumerationswert, der die Quelle identifiziert, die zum Analysieren der Ereignisdaten verwendet wird (z. B. ein Instrumentierungsmanifest der WMI MOF-Klasse).

ProviderNameOffset

Der Offset vom Anfang dieser Struktur zu einer Unicode-Zeichenfolge mit Null-Endung, die den Namen des Anbieters enthält.

LevelNameOffset

Der Offset vom Anfang dieser Struktur bis zu einer unicode-Zeichenfolge mit Null-Endung, die den Namen der Ebene enthält. Mögliche Namen finden Sie unter Hinweise in LevelType.

ChannelNameOffset

Der Offset vom Anfang dieser Struktur zu einer Unicode-Zeichenfolge mit Null-Termin, die den Namen des Kanals enthält. Mögliche Namen finden Sie unter Hinweise in ChannelType.

KeywordsNameOffset

Der Offset vom Anfang dieser Struktur bis zu einer Liste von Unicode-Zeichenfolgen, die null enden, die die Namen der Schlüsselwörter enthält. Die Liste wird mit zwei NULL-Zeichen beendet. Mögliche Namen finden Sie unter Hinweise in KeywordType.

TaskNameOffset

Der Offset vom Anfang dieser Struktur zu einer Unicode-Zeichenfolge mit NULL-Termin, die den Namen des Tasks enthält. Mögliche Namen finden Sie unter Hinweise in TaskType.

OpcodeNameOffset

Der Offset vom Anfang dieser Struktur zu einer unicode-Zeichenfolge mit Null-Endung, die den Namen des Vorgangs enthält. Mögliche Namen finden Sie unter Hinweise in OpcodeType.

EventMessageOffset

Der Offset vom Anfang dieser Struktur zu einer unicode-Zeichenfolge mit Null-Endung, die die Ereignismeldungszeichenfolge enthält. Der Offset ist null, wenn keine Nachrichtenzeichenfolge vorhanden ist. Informationen zu Nachrichtenzeichenfolgen finden Sie unter dem Nachrichtenattribute für EventDefinitionType.

Die Meldungszeichenfolge kann Einfügesequenzen enthalten, z. B. Unable to connect to the %1 printer. Die Nummer der Einfügesequenz identifiziert die -Eigenschaft in den Ereignisdaten, die für die Ersetzung verwendet werden sollen.

ProviderMessageOffset

Der Offset vom Anfang dieser Struktur zu einer unicode-Zeichenfolge mit Null-Endung, die den lokalisierten Anbieternamen enthält.

BinaryXMLOffset

Reserviert.

BinaryXMLSize

Reserviert.

EventNameOffset

ActivityIDNameOffset

Der Offset vom Anfang dieser Struktur zu einer unicode-Zeichenfolge mit NULL-Termin, die den Eigenschaftennamen des Aktivitätsbezeichners in der MOF-Klasse enthält. Wird nur für klassische ETW-Ereignisse unterstützt.

EventAttributesOffset

RelatedActivityIDNameOffset

Der Offset vom Anfang dieser Struktur zu einer mit NULL endendten Unicode-Zeichenfolge, die den Eigenschaftennamen des verknüpften Aktivitätsbezeichners in der MOF-Klasse enthält. Wird nur für ältere ETW-Ereignisse unterstützt.

PropertyCount

Die Anzahl der Elemente im EventPropertyInfoArray-Array .

TopLevelPropertyCount

Die Anzahl der Eigenschaften im EventPropertyInfoArray-Array , die Eigenschaften der obersten Ebene sind. Diese Zahl enthält keine Elemente von Strukturen. Eigenschaften der obersten Ebene stehen vor allen Membereigenschaften im Array.

Flags

Reserviert.

Reserved

Tags

Ein 28-Bit-Wert, der den Ereignismetadaten zugeordnet ist. Dieser Wert kann vom Ereignisanbieter verwendet werden, um einem Ereignis zusätzliche semantische Daten zur Verwendung durch ein Ereignisverarbeitungstool zuzuordnen. Beispielsweise kann ein Tagwert von 5 angeben, dass das Ereignis Debuginformationen enthält. Die Semantik aller Werte in diesem Feld wird vom Ereignisanbieter definiert.

EventPropertyInfoArray[ANYSIZE_ARRAY]

Ein Array von EVENT_PROPERTY_INFO Strukturen, das Informationen zu jeder Eigenschaft der Benutzerdaten des Ereignisses bereitstellt.

Hinweise

Der Wert eines Offsets ist null, wenn der Member nicht definiert ist.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 [nur Desktop-Apps]
Kopfzeile	tdh.h