TRACE_EVENT_INFO structure (tdh.h)
Définit les informations relatives à l’événement.
Syntaxe
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;
Membres
ProviderGuid
GUID qui identifie le fournisseur.
EventGuid
GUID qui identifie la classe MOF qui contient l’événement. Si le fournisseur utilise un manifeste pour définir ses événements, ce membre est GUID_NULL.
EventDescriptor
Structure EVENT_DESCRIPTOR qui décrit l’événement.
DecodingSource
Valeur d’énumération DECODING_SOURCE qui identifie la source utilisée pour analyser les données de l’événement (par exemple, un manifeste d’instrumentation de la classe WMI MOF).
ProviderNameOffset
Décalage entre le début de cette structure et une chaîne Unicode terminée par null qui contient le nom du fournisseur.
LevelNameOffset
Décalage du début de cette structure vers une chaîne Unicode terminée par null qui contient le nom du niveau. Pour connaître les noms possibles, consultez Remarques dans LevelType.
ChannelNameOffset
Décalage entre le début de cette structure et une chaîne Unicode terminée par null qui contient le nom du canal. Pour connaître les noms possibles, consultez Remarques dans ChannelType.
KeywordsNameOffset
Décalage du début de cette structure vers une liste de chaînes Unicode terminées par un caractère Null qui contient les noms des mots clés. La liste se termine par deux caractères NULL. Pour connaître les noms possibles, consultez Remarques dans KeywordType.
TaskNameOffset
Décalage entre le début de cette structure et une chaîne Unicode terminée par null qui contient le nom de la tâche. Pour connaître les noms possibles, consultez Remarques dans TaskType.
OpcodeNameOffset
Décalage du début de cette structure vers une chaîne Unicode terminée par null qui contient le nom de l’opération. Pour connaître les noms possibles, consultez Remarques dans OpcodeType.
EventMessageOffset
Décalage du début de cette structure vers une chaîne Unicode terminée par null qui contient la chaîne de message d’événement. Le décalage est égal à zéro s’il n’y a pas de chaîne de message. Pour plus d’informations sur les chaînes de message, consultez l’attribut message pour EventDefinitionType.
La chaîne de message peut contenir des séquences d’insertion, par exemple, Impossible de se connecter à l’imprimante %1. Le numéro de la séquence d’insertion identifie la propriété dans les données d’événement à utiliser pour la substitution.
ProviderMessageOffset
Décalage entre le début de cette structure et une chaîne Unicode terminée par null qui contient le nom du fournisseur localisé.
BinaryXMLOffset
Réservé.
BinaryXMLSize
Réservé.
EventNameOffset
ActivityIDNameOffset
Décalage du début de cette structure vers une chaîne Unicode terminée par null qui contient le nom de propriété de l’identificateur d’activité dans la classe MOF. Pris en charge pour les événements ETW classiques uniquement.
EventAttributesOffset
RelatedActivityIDNameOffset
Décalage du début de cette structure vers une chaîne Unicode terminée par un caractère Null qui contient le nom de propriété de l’identificateur d’activité associé dans la classe MOF. Pris en charge pour les événements ETW hérités uniquement.
PropertyCount
Nombre d’éléments dans le tableau EventPropertyInfoArray .
TopLevelPropertyCount
Nombre de propriétés du tableau EventPropertyInfoArray qui sont des propriétés de niveau supérieur. Ce nombre n’inclut pas les membres des structures. Les propriétés de niveau supérieur précèdent toutes les propriétés membres du tableau.
Flags
Réservé.
Reserved
Tags
Valeur 28 bits associée aux métadonnées d’événement. Cette valeur peut être utilisée par le fournisseur d’événements pour associer des données sémantiques supplémentaires à un événement à utiliser par un outil de traitement d’événements. Par exemple, une valeur de balise de 5 peut indiquer que l’événement contient des informations de débogage. La sémantique des valeurs de ce champ est définie par le fournisseur d’événements.
EventPropertyInfoArray[ANYSIZE_ARRAY]
Tableau de structures EVENT_PROPERTY_INFO qui fournit des informations sur chaque propriété des données utilisateur de l’événement.
Remarques
La valeur d’un décalage est zéro si le membre n’est pas défini.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows Vista [applications de bureau uniquement] |
| Serveur minimal pris en charge | Windows Server 2008 [applications de bureau uniquement] |
| En-tête | tdh.h |