Freigeben über

StackKeywordLevelFilter

  • Artikel

Das StackKeywordLevelFilter-Element gibt Ereignisschlüsselwörter und -ebene an, um Stackwalk-Ereignisse einzu- oder auszuschließen.

Hinweis

Verfügbar unter Windows 10, Version 1709 und höher.

Elementhierarchie

Syntax

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

  <!-- Child elements -->
  <keyword>

</StackKeywordLevelFilter>

Attribute und Elemente

Attribute

attribute BESCHREIBUNG Datentyp Erforderlich Standard
FilterIn Gibt an, ob die angegebenen Stackwalk-Ereignisse eingeschlossen oder ausgeschlossen werden sollen. boolean Ja
Level Ereignisebene Byte ohne Vorzeichen Nein
Vorgang Gibt an, ob Schlüsselwörter festgelegt oder hinzugefügt werden sollen. Dieses Attribut kann einen der folgenden Werte annehmen:
  • Set
  • Hinzufügen
  • Remove (Entfernen)
 Nein Set

Untergeordnete Elemente

Element BESCHREIBUNG Anforderung
Schlüsselwort Ereignis-Schlüsselwort (keyword) Erforderlich

Übergeordnete Elemente

Element Beschreibung
EventProvider Stellt einen Ereignisanbieter für das Profil dar.

Anmerkung

Wenn das Stapelgehen für einen Anbieter aktiviert ist, wird der Stapel für alle vom Anbieter generierten Ereignisse erfasst. In den meisten Fällen ist der Benutzer nur an einem Stapel von nur einer bestimmten Anzahl von Ereignissen interessiert. Dieses Element ermöglicht das Aktivieren oder Deaktivieren des Stapelgehens basierend auf Schlüsselwort (keyword) und Ebene.

Obwohl ETW leistungsstarke Nutzlast- und Attributfilterung unterstützt, sollten Ereignisse in erster Linie basierend auf Bereichsfiltern oder über Ebene und Schlüsselwort (keyword) gefiltert werden, um den CPU-Aufwand zu reduzieren.

Beispiel

    <EventProvider Id="EventProvider_TraceLogGen" Name="*TraceLogGen">
      <StackKeywordLevelFilter FilterIn="true" Level="5">
        <Keyword Value="0x10000000000000"/>
      </StackKeywordLevelFilter>
    </EventProvider>

Elemente