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

Voir aussi

PROVIDER_FILTER_INFO

TRACE_EVENT_INFO