EVENT_PROPERTY_INFO-Struktur (tdh.h)

Stellt Informationen zu einer einzelnen Eigenschaft des Ereignisses oder Filters bereit.

Syntax

typedef struct _EVENT_PROPERTY_INFO {
  PROPERTY_FLAGS Flags;
  ULONG          NameOffset;
  union {
    struct {
      USHORT InType;
      USHORT OutType;
      ULONG  MapNameOffset;
    } nonStructType;
    struct {
      USHORT StructStartIndex;
      USHORT NumOfStructMembers;
      ULONG  padding;
    } structType;
    struct {
      USHORT InType;
      USHORT OutType;
      ULONG  CustomSchemaOffset;
    } customSchemaType;
  };
  union {
    USHORT count;
    USHORT countPropertyIndex;
  };
  union {
    USHORT length;
    USHORT lengthPropertyIndex;
  };
  union {
    ULONG Reserved;
    struct {
      ULONG Tags : 28;
    };
  };
} EVENT_PROPERTY_INFO;

Member

Flags

Flags, die angeben, ob die Eigenschaft in einer Struktur oder einem Array enthalten ist. Mögliche Werte finden Sie in der PROPERTY_FLAGS-Enumeration .

NameOffset

Offset auf eine mit NULL endende Unicode-Zeichenfolge, die den Namen der Eigenschaft enthält. Wenn dies eine Ereigniseigenschaft ist, erfolgt der Offset vom Anfang der TRACE_EVENT_INFO-Struktur . Wenn es sich um eine Filtereigenschaft handelt, erfolgt der Offset vom Anfang der PROVIDER_FILTER_INFO-Struktur .

nonStructType

Verwenden Sie diese Member, wenn das PropertyStruct-Flag in Flags nicht festgelegt ist. Verwenden Sie andernfalls das Element structType .

nonStructType.InType

Datentyp dieser Eigenschaft bei der Eingabe. Eine Beschreibung dieser Typen finden Sie unter Hinweise in InputType.

Beschreibungen dieser Typen finden Sie unter MOF-Qualifizierer für die Ereignisablaufverfolgung.

TdhGetPropertySizeTdhGetPropertySize

nonStructType.OutType

Ausgabeformat für diese Eigenschaft. Wenn der Wert TDH_OUTTYPE_NULL ist, verwenden Sie im -Typ als Ausgabeformat. Eine Beschreibung dieser Typen finden Sie unter Hinweise in InputType.

Beschreibungen dieser Typen finden Sie unter MOF-Qualifizierer für die Ereignisablaufverfolgung.

nonStructType.MapNameOffset

Offset vom Anfang der TRACE_EVENT_INFO-Struktur zu einer unicode-Zeichenfolge mit NULL-Termin, die den Namen des Zuordnungsattributwerts enthält. Sie können diese Zeichenfolge an TdhGetEventMapInformation übergeben, um Informationen zur Wertzuordnung abzurufen.

structType

Verwenden Sie diese Member, wenn das PropertyStruct-Flag in Flags festgelegt ist. Verwenden Sie andernfalls das Element nonStructType .

structType.StructStartIndex

Nullbasierter Index für das Element des Eigenschaftenarrays, das den ersten Member der Struktur enthält.

structType.NumOfStructMembers

Anzahl der Elemente in der -Struktur.

structType.padding

Wird nicht verwendet.

customSchemaType

Verwenden Sie diese Member, wenn das Flag PropertyHasCustomSchema in Flags festgelegt ist. Verwenden Sie andernfalls das Element nonStructType .

customSchemaType.InType

customSchemaType.OutType

Ausgabeformat für diese Eigenschaft. Wenn der Wert TDH_OUTTYPE_NULL ist, verwenden Sie im -Typ als Ausgabeformat. Eine Beschreibung dieser Typen finden Sie unter Hinweise in InputType.

Beschreibungen dieser Typen finden Sie unter MOF-Qualifizierer für die Ereignisablaufverfolgung.

customSchemaType.CustomSchemaOffset

Offset (in Bytes) vom Anfang der TRACE_EVENT_INFO-Struktur bis zu den benutzerdefinierten Schemainformationen. Die benutzerdefinierten Schemainformationen enthalten einen 2-Byte-Protokollbezeichner, gefolgt von einer Schemalänge von 2 Byte, gefolgt vom Schema.

count

Anzahl der Elemente im Array. Beachten Sie, dass dieser Wert für Eigenschaften, die nicht als Array definiert sind, 1 ist.

countPropertyIndex

Nullbasierter Index für das Element des Eigenschaftenarrays, das die Anzahl der Elemente im Array enthält. Verwenden Sie diesen Member, wenn das PropertyParamCount-Flag in Flags festgelegt ist. Verwenden Sie andernfalls das Count-Element .

length

Größe der Eigenschaft in Bytes. Beachten Sie, dass Typen mit variabler Größe, z. B. Zeichenfolgen und Binärdaten, eine Länge von 0 (null) aufweisen, es sei denn, die Eigenschaft verfügt über ein length-Attribut, das die tatsächliche Länge explizit angibt. Strukturen haben eine Länge von 0 (null).

lengthPropertyIndex

Nullbasierter Index für das Element des Eigenschaftenarrays, das den Größenwert dieser Eigenschaft enthält. Verwenden Sie diesen Member, wenn das PropertyParamLength-Flag in Flags festgelegt ist. Verwenden Sie andernfalls den Längenmember.

Reserved

Reserviert.

Tags

Ein 28-Bit-Wert, der den Feldmetadaten zugeordnet ist. Dieser Wert ist nur gültig, wenn das PropertyHasTags-Flag festgelegt ist. Dieser Wert kann vom Ereignisanbieter verwendet werden, um zusätzliche semantische Daten einem Feld zur Verwendung durch ein Ereignisverarbeitungstool zuzuordnen. Beispielsweise kann ein Tagwert von 1 angeben, dass das Feld einen Benutzernamen enthält. Die Semantik aller Werte in diesem Feld wird vom Ereignisanbieter definiert.

Hinweise

Filter unterstützen keine Zuordnungen, Strukturen oder Arrays.

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

Weitere Informationen

PROVIDER_FILTER_INFO

TRACE_EVENT_INFO