Microsoft DirectX 9.0 SDK Update (October 2004)

PresentFlag Enumeration

Language:

Note: This documentation is preliminary and is subject to change.

Defines flags that control a Device.Present operation.

Definition

Visual Basic .NET Public Enum PresentFlag
C# public enum PresentFlag
Managed C++ __value public enum PresentFlag
JScript .NET 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 Microsoft® 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.2902.0,  Culture=neutral,  PublicKeyToken=31bf3856ad364e35

© 2004 Microsoft Corporation. All rights reserved. Terms of use.

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