StackKeywordLevelFilter

StackKeywordLevelFilter 元素會指定要包含或排除 stackwalk 事件的事件關鍵字和層級。

注意

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

元素階層

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

Syntax

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

  <!-- Child elements -->
  <keyword>

</StackKeywordLevelFilter>

屬性和項目

屬性

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

子元素

元素	描述	需求
關鍵字	Event 關鍵字	必要

父項目

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

備註

當提供者啟用堆疊逐步執行時，就會針對提供者所產生的所有事件擷取堆疊。 大部分時候，使用者只會對來自特定事件數目的堆疊感興趣。 這個專案允許根據關鍵字和層級啟用或停用堆疊逐步執行。

雖然 ETW 支援強大的承載和屬性篩選，但事件主要是篩選型範圍篩選，或透過層級和關鍵字篩選，以降低 CPU 額外負荷。

範例

    <EventProvider Id="EventProvider_TraceLogGen" Name="*TraceLogGen">
      <StackKeywordLevelFilter FilterIn="true" Level="5">
        <Keyword Value="0x10000000000000"/>
      </StackKeywordLevelFilter>
    </EventProvider>

相關主題

元素