StackFilters

StackFilters 要素は、マニフェスト ベースのプロバイダーにスタックを含めるか除外するイベント ID を指定します。

注意

Windows 10 バージョン 1709 以降で使用できます。

要素の階層

• < WindowsPerformanceRecorder>
  • < プロファイル>
    • < EventProvider>
      • < StackFilters>
    • < Profile>
      • < コレクター>
        • < EventCollectorId>
          • < EventProviders>
            • < EventProvider>
              • < StackFilters>

構文

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

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

</StackFilters>

属性および要素

属性

属性	説明	データ型	必須	Default
FilterIn	指定したイベントを含めるか除外するかを示します。	boolean	はい
操作	キーワードを設定するか、追加するかを示します。	この属性は、次のいずれかの値になります。 オン 追加 削除	いいえ	オン

子要素

要素	説明	要件
EventId	マニフェストで定義されているイベント ID。	必須、1 つ以上。

親要素

要素	説明
EventProvider	プロファイルのイベント プロバイダーを表します。

注記

プロバイダーに対してスタック ウォークが有効になっている場合、プロバイダーによって生成されたすべてのイベントに対してスタックがキャプチャされます。 ほとんどの場合、ユーザーは特定の数のイベントからのスタックにのみ関心があります。 この要素を使用すると、イベント ID に基づいて、イベントの一覧でスタック ウォークを有効または無効にできます。

ETW では強力なペイロードと属性のフィルター処理がサポートされていますが、CPU オーバーヘッドを減らすには、主にフィルター処理ベースのスコープ フィルターまたはレベルとキーワード (keyword)を使用してイベントをフィルター処理する必要があります。

例

    <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>

関連トピック

要素