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 |