緩衝區

發行項
07/17/2024

根據 PercentageOfTotalMemory 屬性的值，描述啟動會話時要配置的緩衝區數目，或要配置給會話的總記憶體百分比。

元素階層

< WindowsPerformanceRecorder>
- < 配置檔>
  - < SystemCollector>
    - < 緩衝區>
  - < EventCollector>
    - < 緩衝區>
  - < HeapEventCollector>
    - < 緩衝區>
  - < 配置檔>
    - < 收藏家>
      - < SystemCollectorId>
        
        < 緩衝區>
      - < EventCollectorId>
        
        < 緩衝區>
      - < HeapEventCollectorId>
        
        < 緩衝區>

Syntax

<Buffers Operation               = "Set" | "Add" | “Remove”
         Value                   = unsignedLong
         PercentageOfTotalMemory = Boolean
         MaximumBufferSpace      = unsignedLong >
</Buffers>

屬性和項目

屬性

屬性	描述	資料類型	必要	預設
MaximumBufferSpace	表示將用於收集的緩衝區大小上限，以 MB 為單位。只有在 PercentageOfTotalMemory 為 `true` 時，才會套用此值。	unsignedLong	No
運算	指出是否應該設定或新增緩衝區。	此屬性可以有下列其中一個值：集合加移除	No	集合
PercentageOfTotalMemory	當設定為 `true` 時，會將可取用的記憶體數量限制為 Value的值。	Boolean	No	false
值	指出緩衝區數目，如果 PercentageOfTotalMemory 設定 `true` 為，則表示緩衝區的記憶體百分比。	unsignedLong	Yes

子元素

無。

父項目

元素	描述
EventCollector	表示事件收集器。
EventCollectorId	表示事件收集器識別碼。
HeapEventCollector	表示堆積事件收集器。
HeapEventCollectorId	表示堆積事件收集器識別碼。
SystemCollector	表示系統收集器。
SystemCollectorId	表示系統收集器識別碼。

備註

這個專案僅用於記憶體內部擷取。

範例

下列範例示範如何在系統收集器和事件收集器定義中使用這個專案。

第一個範例會將緩衝區大小設定為 512 KB，並將耗用的記憶體總數限制為 3%。第二個範例會設定每個緩衝區 128 KB 的 64 個緩衝區。

<SystemCollector
  Id="WPRSystemCollector"
  Name="NT Kernel Logger"
  FileName="WPRKernel.etl">
  <BufferSize
    Value="512"/> 
  <Buffers
    Value="3"
    PercentageOfTotalMemory="true"/>
</SystemCollector>

<EventCollector
  Id="WPREventCollector"
  Name="WPR Event Collector"
  FileName="somefilename.etl">
  <BufferSize
    Value="128"/>
  <Buffers
    Value="64"/>
</EventCollector>