EVENT_PROPERTY_INFO structure (tdh.h)
Fournit des informations sur une seule propriété de l’événement ou du filtre.
Syntaxe
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;
Membres
Flags
Indicateurs qui indiquent si la propriété est contenue dans une structure ou un tableau. Pour connaître les valeurs possibles, consultez l’énumération PROPERTY_FLAGS .
NameOffset
Décalage vers une chaîne Unicode terminée par null qui contient le nom de la propriété. S’il s’agit d’une propriété d’événement, le décalage est à partir du début de la structure TRACE_EVENT_INFO . S’il s’agit d’une propriété de filtre, le décalage est à partir du début de la structure PROVIDER_FILTER_INFO .
nonStructType
Utilisez ces membres si l’indicateur PropertyStruct dans Flags n’est pas défini ; sinon, utilisez le membre structType .
nonStructType.InType
Type de données de cette propriété en entrée. Pour obtenir une description de ces types, consultez Remarques dans InputType.
Pour obtenir une description de ces types, consultez Qualificateurs MOF de suivi d’événements.
TdhGetPropertySizeTdhGetPropertySize
nonStructType.OutType
Format de sortie pour cette propriété. Si la valeur est TDH_OUTTYPE_NULL, utilisez dans le type comme format de sortie. Pour obtenir une description de ces types, consultez Remarques dans InputType.
Pour obtenir une description de ces types, consultez Qualificateurs MOF de suivi d’événements.
nonStructType.MapNameOffset
Décalage à partir du début de la structure TRACE_EVENT_INFO vers une chaîne Unicode terminée par une valeur Null qui contient le nom de la valeur de l’attribut de carte. Vous pouvez passer cette chaîne à TdhGetEventMapInformation pour récupérer des informations sur le mappage de valeurs.
structType
Utilisez ces membres si l’indicateur PropertyStruct dans Flags est défini ; sinon, utilisez le membre nonStructType .
structType.StructStartIndex
Index de base zéro pour l’élément du tableau de propriétés qui contient le premier membre de la structure.
structType.NumOfStructMembers
Nombre de membres dans la structure.
structType.padding
Non utilisé.
customSchemaType
Utilisez ces membres si l’indicateur PropertyHasCustomSchema dans Flags est défini ; sinon, utilisez le membre nonStructType .
customSchemaType.InType
customSchemaType.OutType
Format de sortie pour cette propriété. Si la valeur est TDH_OUTTYPE_NULL, utilisez dans le type comme format de sortie. Pour obtenir une description de ces types, consultez Remarques dans InputType.
Pour obtenir une description de ces types, consultez Qualificateurs MOF de suivi d’événements.
customSchemaType.CustomSchemaOffset
Décalage (en octets) du début de la structure TRACE_EVENT_INFO vers les informations de schéma personnalisées. Les informations de schéma personnalisées contiennent un identificateur de protocole de 2 octets, suivi d’une longueur de schéma de 2 octets, suivi du schéma.
count
Nombre d’éléments dans le tableau. Notez que cette valeur est 1 pour les propriétés qui ne sont pas définies en tant que tableau.
countPropertyIndex
Index de base zéro pour l’élément du tableau de propriétés qui contient le nombre d’éléments dans le tableau. Utilisez ce membre si l’indicateur PropertyParamCount dans Indicateurs est défini ; sinon, utilisez le membre count .
length
Taille de la propriété, en octets. Notez que les types de taille variable tels que les chaînes et les données binaires ont une longueur de zéro, sauf si la propriété a un attribut length pour indiquer explicitement sa longueur réelle. Les structures ont une longueur de zéro.
lengthPropertyIndex
Index de base zéro pour l’élément du tableau de propriétés qui contient la valeur de taille de cette propriété. Utilisez ce membre si l’indicateur PropertyParamLength dans Flags est défini ; sinon, utilisez le membre de longueur .
Reserved
Réservé.
Tags
Valeur 28 bits associée aux métadonnées de champ. Cette valeur est valide uniquement si l’indicateur PropertyHasTags est défini. Cette valeur peut être utilisée par le fournisseur d’événements pour associer des données sémantiques supplémentaires à un champ à utiliser par un outil de traitement d’événements. Par exemple, une valeur de balise de 1 peut indiquer que le champ contient un nom d’utilisateur. La sémantique des valeurs de ce champ est définie par le fournisseur d’événements.
Remarques
Les filtres ne prennent pas en charge les cartes, les structures ou les tableaux.
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 |