Share via

PresentParameters.BackBufferCount Property (Microsoft.DirectX.Direct3D)

  • Article

Retrieves or sets the number of back buffers.

Definition

Visual Basic Public Property BackBufferCount As Integer
C# public int BackBufferCount { get; set; }
C++ public:
property int BackBufferCount {
        int get();
        void set(int value);
}
JScript public function get BackBufferCount() : int
public function set BackBufferCount(int);

Property Value

System.Int32
Number of back buffers.

This property is read/write. 

Remarks

This value can be 0 (or 1), 2, or 3. Zero is treated as 1. If the specified number of back buffers cannot be created, the runtime fails the method call and fills the value with the number of back buffers that it was able to create. This behavior means that an application can call the method twice with the same PresentParameters structure and expect it to work the second time.

The method fails if one back buffer cannot be created. The value of BackBufferCount influences which set of swap effects is allowed; specifically, any SwapEffect.Copy swap effect requires that there be exactly one back buffer.