EventNameFilters

EventNameFilters 元素包含或排除基于其名称的跟踪记录事件。

注意

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

元素层次结构

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

语法

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

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

</EventNameFilters>

特性和元素

特性

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

子元素

元素	说明	要求
EventName	跟踪日志事件名称。	必需，1 个或多个。
关键字	事件关键字 (keyword)	可选

父元素

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

备注

EventNameFilters 元素通过 EVENT_FILTER_DESCRIPTOR、Type EVENT_FILTER_TYPE_EVENT_NAME 启用事件筛选。

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

示例

    <EventProvider Id="EventProvider_TraceLogGen" Name="3970F9cf-2c0c-4f11-b1cc-e3a1e9958833">
      <EventNameFilters FilterIn="true" Level="5">
        <Keyword Value="0x10000000000000"/>
        <EventName Value="Preset1"/>
        <EventName Value="Preset2"/>
      </EventNameFilters>
    </EventProvider>

相关主题

元素