PresentFlag Enumeration

Language:

Defines flags that control a Device.Present operation.

Definition

Visual Basic Public Enum PresentFlag
C# public enum PresentFlag
C++ public enum class PresentFlag
JScript public enum PresentFlag

Members

Member Value Description
Video 16 Informs the driver that the back buffers contain video data.
DeviceClip 4 Clips a windowed Device.Present blit into the window client area, within the monitor screen area of the video adapter that created the Microsoft Direct3D device. This flag works only on Microsoft Windows 2000 and Windows XP.
DiscardDepthStencil 2 Enables z-buffer discarding if set when the device or swap chain is created. When this flag is set, the contents of the depth stencil buffer are invalid after either Device.Present or Device.DepthStencilSurface are called.

Discarding z-buffer data can increase performance and is dependent on the driver. The debug runtime enforces discarding by clearing the z-buffer to some constant value after calling either Device.Present or Device.DepthStencilSurface with a different depth surface.

Discarding z-buffer data is illegal for all lockable formats, D16Lockable, and D32Lockable. Using Device.Device to specify a lockable format and z-buffer discarding will result in failure. For more information about formats, see Format.
LockableBackBuffer 1 Gives the application the ability to lock the back buffer directly. Note that back buffers are not lockable unless the application specifies LockableBackBuffer when calling Device.Device or Device.Reset. Lockable back buffers incur a performance cost on some graphics hardware configurations.

Performing a lock operation (or using Device.UpdateSurface to write on the lockable back buffer) decreases performance on many cards. In this case, consider using textured triangles to move data to the back buffer.
None 0 Use no presentation flags.

Enumeration Information

Namespace Microsoft.DirectX.Direct3D
Assembly Microsoft.DirectX.Direct3D (microsoft.directx.direct3d.dll)
Strong Name Microsoft.DirectX.Direct3D,  Version=1.0.900.0,  Culture=neutral,  PublicKeyToken=d3231b57b74a1492

Send comments about this topic to Microsoft. © Microsoft Corporation. All rights reserved.

Feedback? Please provide us with your comments on this topic.
For more help, visit the DirectX Developer Center