Partager via


EventNameFilters

L’élément EventNameFilters inclut ou exclut les événements de traçage en fonction de leurs noms.

Notes

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

Hiérarchie d’éléments

Syntaxe

<EventNameFilters FilterIn="true|false" Level="unsigned byte" Operation ="Set|Add|Remove" >

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

</EventNameFilters>

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.
Mot clé Mot clé d’événements Facultatif

Éléments parents

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

Remarque

L’élément EventNameFilters permet le filtrage des événements via EVENT_FILTER_DESCRIPTOR, Type EVENT_FILTER_TYPE_EVENT_NAME.

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="3970F9cf-2c0c-4f11-b1cc-e3a1e9958833">
      <EventNameFilters FilterIn="true" Level="5">
        <Keyword Value="0x10000000000000"/>
        <EventName Value="Preset1"/>
        <EventName Value="Preset2"/>
      </EventNameFilters>
    </EventProvider>

Éléments