StackKeywordLevelFilter

StackKeywordLevelFilter 元素指定事件关键字和级别以包含或排除 stackwalk 事件。

注意

适用于 Windows 10 版本 1709 及更高版本。

元素层次结构

• < WindowsPerformanceRecorder>
  • < Profiles>
    • < EventProvider>
      • < StackKeywordLevelFilter>
    • < Profile>
      • < Collectors>
        • < EventCollectorId>
          • < EventProviders>
            • < EventProvider>
              • < StackKeywordLevelFilter>

语法

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

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

</StackKeywordLevelFilter>

特性和元素

特性

属性	说明	数据类型	必须	默认
FilterIn	指示是包含还是排除指定的 stackwalk 事件。	boolean	是
级别	事件级别	无符号字节	否
操作	指示是应设置还是添加关键字。	此属性可以具有以下值之一： 设置 添加 删除	否	设置

子元素

元素	说明	要求
关键字	事件关键字 (keyword)	必须

父元素

元素	说明
EventProvider	表示配置文件的事件提供程序。

备注

为提供程序启用堆栈浏览后，将捕获提供程序生成的所有事件的堆栈。 大多数情况下，用户只对来自特定数量的事件的堆栈感兴趣。 此元素允许根据关键字 (keyword) 和级别启用或禁用堆栈行走。

尽管 ETW 支持强大的有效负载和属性筛选，但事件应主要基于范围筛选器进行筛选，或通过级别和关键字 (keyword) 来减少 CPU 开销。

示例

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

相关主题

元素