缓冲区

项目
07/17/2024

描述在启动会话时要分配的缓冲区数或者要为会话分配的总内存百分比（具体取决于 PercentageOfTotalMemory 属性的值）。

元素层次结构

< WindowsPerformanceRecorder>
- < Profiles>
  - < SystemCollector>
    - < 缓冲区>
  - < EventCollector>
    - < 缓冲区>
  - < HeapEventCollector>
    - < 缓冲区>
  - < Profile>
    - < Collectors>
      - < SystemCollectorId>
        
        < 缓冲区>
      - < EventCollectorId>
        
        < 缓冲区>
      - < HeapEventCollectorId>
        
        < 缓冲区>

语法

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

特性和元素

特性

属性	说明	数据类型	必须	默认
MaximumBufferSpace	指示将用于收集的缓冲区的最大大小（以兆字节为单位）。此值仅适用于 PercentageOfTotalMemory 为 `true` 的情况。	unsignedLong	否
操作	指示是应设置还是添加缓冲区。	此属性可以具有以下值之一：设置添加删除	否	设置
PercentageOfTotalMemory	当设置为 `true`时，可以使用的内存量限制为 Value 的值。	布尔	否	false
值	指示缓冲区的数量，或者如果将 PercentageOfTotalMemory 设置为 `true`，则指示缓冲区的内存百分比。	unsignedLong	是

子元素

无。

父元素

元素	说明
EventCollector	表示事件收集器。
EventCollectorId	表示事件收集器标识符。
HeapEventCollector	表示堆事件收集器。
HeapEventCollectorId	表示堆事件收集器标识符。
SystemCollector	表示系统收集器。
SystemCollectorId	表示系统收集器标识符。

注解

此元素仅用于内存中捕获。

示例

以下示例显示了如何在系统收集器和事件收集器定义中使用此元素。

第一个示例将缓冲区大小设置为 512 KB，并将占用的内存总量限制为 3%。第二个示例设置 64 个缓冲区，每个缓冲区的大小为 128 KB。

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