EventNameFilters

EventNameFilters 元素會根據其名稱包含或排除追蹤記錄事件。

注意

可在 Windows 10 1709 版和更新版本上使用。

元素階層

• < WindowsPerformanceRecorder>
  • < 配置 檔>
    • < EventProvider>
      • < EventNameFilters>
    • < 配置 檔>
      • < 收藏家>
        • < EventCollectorId>
          • < EventProviders>
            • < EventProvider>
              • < EventNameFilters>

Syntax

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

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

</EventNameFilters>

屬性和項目

屬性

屬性	描述	資料類型	必要	預設
FilterIn	指出是否要包含或排除指定的 stackwalk 事件。	boolean	是
Level	事件層級	不帶正負號的位元組	No
運算	指出是否應該設定或新增關鍵字。	此屬性可以有下列其中一個值： 集合 加 移除	No	集合

子元素

元素	描述	需求
EventName	追蹤記錄事件名稱。	必要，1 或更多。
關鍵字	事件關鍵字	選擇性

父項目

元素	描述
EventProvider	表示設定檔的事件提供者。

備註

EventNameFilters 元素可透過EVENT_FILTER_DESCRIPTOR類型EVENT_FILTER_TYPE_EVENT_NAME啟用事件篩選。

雖然 ETW 支援強大的承載和屬性篩選，但事件主要是篩選型範圍篩選，或透過層級和關鍵字篩選，以降低 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>

相關主題

元素