Buffers

Updated: October 20, 2013

Applies To: Windows 8, Windows 8.1

Describes either the number of buffers to be allocated when starting a session or the percentage of total memory to be allocated for the session, depending on the value of the PercentageOfTotalMemory attribute.

<WindowsPerformanceRecorder>
     <Profiles>
          <SystemCollector>
               <Buffers>

          <EventCollector>
               <Buffers>

          <HeapEventCollector
               <Buffers>

          <Profile>
               <Collectors>
                    <SystemCollectorId>
                         <Buffers>

                    <EventCollectorId>
                         <Buffers>

                    <HeapEventCollectorId>
                         <Buffers>


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

 

Attribute Description Data type Required Default

Operation

Indicates whether buffers should be set or added.

This attribute can have one of the following values:

  • Set

  • Add

  • Remove

No

Set

Value

Indicates the number of buffers, or if PercentageOfTotalMemory is set to "true", the percentage of memory for the buffers.

unsignedLong

Yes

PercentageOfTotalMemory

When set to "true", limits the amount of memory that can be consumed to the value of Value.

boolean

No

false

 

Element Description

EventCollector

Represents an event collector.

EventCollectorId

Represents an event collector identifier.

HeapEventCollector

Represents a heap event collector.

HeapEventCollectorId

Represents a heap event collector identifier.

SystemCollector

Represents a system collector.

SystemCollectorId

Represents a system collector identifier.

This element is used only for in-memory capture.

The following examples show how this element is used in system collector and event collector definitions.

The first example sets the buffer size to 512 KB and limits the total amount of memory consumed to 3 percent. The second example sets 64 buffers of 128 KB each.

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

Show: