StackEventNameFilters

StackEventNameFilters 元素指定事件名称，以包含或排除跟踪记录提供程序中的 stackwalk 事件。

注意

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

元素层次结构

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

语法

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

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

</StackEventNameFilters>

特性和元素

特性

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

子元素

元素	说明	要求
EventName	跟踪日志事件名称。	必需，1 个或多个。

父元素

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

备注

为提供程序启用堆栈浏览后，将捕获提供程序生成的所有事件的堆栈。 大多数情况下，用户只对来自特定数量的事件的堆栈感兴趣。

此元素允许启用或禁用基于事件 ID 的事件列表上的堆栈浏览。

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

示例

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

相关主题

元素