PresentParameters.BackBufferFormat Property

Article
10/15/2009

[This documentation is for preview only, and is subject to change in later releases. Blank topics are included as placeholders.]

Retrieves or sets the format of the back buffer.

Namespace: Microsoft.WindowsMobile.DirectX.Direct3D
Assembly: Microsoft.WindowsMobile.DirectX (in Microsoft.WindowsMobile.DirectX.dll)

Syntax

'Declaration
Public Property BackBufferFormat As Format
    Get
    Set
'Usage
Dim instance As PresentParameters
Dim value As Format

value = instance.BackBufferFormat

instance.BackBufferFormat = value

public Format BackBufferFormat { get; set; }

public:
property Format BackBufferFormat {
    Format get ();
    void set (Format value);
}

member BackBufferFormat : Format with get, set

Property Value

Type: Microsoft.WindowsMobile.DirectX.Direct3D.Format
Format of the back buffer.

Remarks

This value must be one of the render target formats as validated by CheckDeviceType for a Manager. Use the DisplayMode of a Device to obtain the current format. For more information about formats, see Format.

While in windowed mode, you can specify an Unknown format for the BackBufferFormat. This tells the runtime to use the current display-mode format and eliminates the need to call DisplayMode for a Device.

For windowed applications, the back buffer format does not need to match the display-mode format because color conversion can be done by the hardware provided the hardware supports it. The set of possible back buffer formats is constrained, but the runtime allows any valid back buffer format to be presented to any desktop format. The device also must be operable in desktop mode, since devices typically do not operate in 8-bits-per-pixel modes.

Full-screen applications cannot perform color conversion.

.NET Framework Security

Full trust for the immediate caller. This member cannot be used by partially trusted code. For more information, see Using Libraries from Partially Trusted Code.

Platforms

Windows CE, Windows Mobile for Smartphone, Windows Mobile for Pocket PC

The .NET Framework and .NET Compact Framework do not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

Version Information

.NET Compact Framework

Supported in: 3.5, 2.0