Partager via


StackEventNameFilters

L’élément StackEventNameFilters spécifie des noms d’événements pour inclure ou exclure des événements stackwalk d’un fournisseur de suivi.

Notes

Disponible sur Windows 10, version 1709 et ultérieure.

Hiérarchie d’éléments

Syntaxe

<StackEventNameFilters FilterIn = "true|false" Operation = "Set|Add|Remove" >

  <!-- Child elements -->
  <EventName>

</StackEventNameFilters>

Attributs et éléments

Attributs

Attribut Description Type de données Obligatoire Default
FilterIn Indique s’il faut inclure ou exclure les événements stackwalk spécifiés. boolean Oui
Niveau niveau d’événement Octet non signé Non
opération Indique si les mots clés doivent être définis ou ajoutés. Cet attribut peut avoir l’une des valeurs suivantes :
  • Définissez
  • Ajouter
  • Supprimer
Non Définissez

Éléments enfants

Élément Description Condition requise
EventName Nom de l’événement tracelogging. Obligatoire, 1 ou plus.

Éléments parents

Élément Description
Eventprovider Représente un fournisseur d’événements pour le profil.

Remarque

Lorsque la marche à pas de pile est activée pour un fournisseur, la pile est capturée pour tous les événements générés par le fournisseur. La plupart du temps, l’utilisateur ne s’intéresse qu’à la pile à partir d’un certain nombre d’événements.

Cet élément permet d’activer ou de désactiver la marche de la pile sur une liste d’événements basée sur des ID d’événement.

Même si ETW prend en charge un filtrage puissant de charge utile et d’attributs, les événements doivent principalement être des filtres d’étendue basés sur un filtrage ou via le niveau et mot clé pour réduire la surcharge du processeur.

 Exemple

    <EventProvider Id="EventProvider_TraceLogGen" Name="*TraceLogGen">
      <StackEventNameFilters FilterIn="true" Level="5">
        <Keyword Value="0x10000000000000"/>
        <EventName Value="Preset1"/>
        <EventName Value="Preset2"/>
      </StackEventNameFilters>
    </EventProvider>

Éléments