StackFilters

StackFilters 元素指定要包含或排除基于清单的提供程序中的堆栈的事件 ID。

注意

可在 Windows 10 版本 1709 及更高版本上使用。

元素层次结构

语法

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

  <!-- Child elements -->
  <EventId>

</StackFilters>

特性和元素

特性

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

子元素

元素 说明 要求
EventId 清单中定义的事件 ID。 必需,1 个或多个。

父元素

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

备注

为提供程序启用堆栈行走后,将为提供程序生成的所有事件捕获堆栈。 大多数情况下,用户只对某些事件数量的堆栈感兴趣。 此元素允许启用或禁用基于事件 ID 的事件列表上的堆栈行走。

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

示例

    <EventProvider Id="EP_Microsoft-Windows-Win32k" Name="8c416c79-d49b-4f01-a467-e56d3aa8234c" NonPagedMemory="true">
      <EventFilters FilterIn="false">
        <EventId Value="164" />
        <EventId Value="166" />
        <EventId Value="167" />
        <EventId Value="169" />
      </EventFilters>
      <StackFilters FilterIn="true">
        <EventId Value="88" />
        <EventId Value="65" />
      </StackFilters>
    </EventProvider>

元素