StackFilters
StackFilters 元素指定要从基于清单的提供程序中包含或排除堆栈的事件 ID。
注意
适用于 Windows 10 版本 1709 及更高版本。
元素层次结构
-
<
WindowsPerformanceRecorder>
-
<
Profiles>
-
<
EventProvider>
- < StackFilters>
-
<
Profile>
-
<
Collectors>
-
<
EventCollectorId>
-
<
EventProviders>
-
<
EventProvider>
- < StackFilters>
-
<
EventProvider>
-
<
EventProviders>
-
<
EventCollectorId>
-
<
Collectors>
-
<
EventProvider>
-
<
Profiles>
语法
<StackFilters FilterIn = "true" | "false" Operation = "Set" | "Add" | "Remove" >
<!-- Child elements -->
<EventId>
</StackFilters>
特性和元素
特性
属性 | 说明 | 数据类型 | 必须 | 默认 |
---|---|---|---|---|
FilterIn | 指示是包含还是排除指定的事件。 | boolean | 是 | |
操作 | 指示是应设置还是添加关键字。 | 此属性可以具有以下值之一:
|
否 | 设置 |
子元素
元素 | 说明 | 要求 |
---|---|---|
EventId | 清单中定义的事件 ID。 | 必需,1 个或多个。 |
父元素
元素 | 说明 |
---|---|
EventProvider | 表示配置文件的事件提供程序。 |
备注
为提供程序启用堆栈遍走后,将针对提供程序生成的所有事件捕获堆栈。 大多数情况下,用户只对来自特定数量的事件的堆栈感兴趣。 此元素允许启用或禁用基于事件 ID 的事件列表上的堆栈遍走。
尽管 ETW 支持强大的有效负载和属性筛选,但事件应主要基于范围筛选器进行筛选,或者通过级别和关键字 (keyword) 来减少 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>