?/TD>
Microsoft DirectX 9.0

D3DPRESENTFLAG


Constants used by D3DPRESENT_PARAMETERS.

#defineDescriptionValue
D3DPRESENTFLAG_LOCKABLE_BACKBUFFER0x00000001Set this flag if the application requires the ability to lock the back buffer directly. Note that back buffers are not lockable unless the application specifies D3DPRESENTFLAG_LOCKABLE_BACKBUFFER when calling IDirect3D9::CreateDevice or IDirect3DDevice9::Reset. Lockable back buffers incur a performance cost on some graphics hardware configurations.

Performing a lock operation (or using IDirect3DDevice9::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.

D3DPRESENTFLAG_DISCARD_DEPTHSTENCIL0x00000002Set this flag when the device or swap chain is created to enable z-buffer discarding. If this flag is set, the contents of the depth stencil buffer will be invalid after calling either IDirect3DDevice9::Present, or IDirect3DDevice9::SetDepthStencilSurface with a different depth surface.

Discarding z-buffer data can increase performance and is driver dependent. The debug runtime will enforce discarding by clearing the z-buffer to some constant value after calling either IDirect3DDevice9::Present, or IDirect3DDevice9::SetDepthStencilSurface with a different depth surface.

Discarding z-buffer data is illegal for all lockable formats, D3DFMT_D16_LOCKABLE and D3DFMT_D32F_LOCKABLE. Any use of IDirect3D9::CreateDevice specifying a lockable format and z-buffer discarding will fail. For more information about formats, see D3DFORMAT.

D3DPRESENTFLAG_DEVICECLIP0x00000004Clip a windowed IDirect3DDevice9::Present?SPAN CLASS="clsGlossary" onmouseover="showDef()" onmouseout="clearDef()" G_RID="term_blit">blit into the window client area, within the monitor screen area of the video adapter that created the Microsoft?Direct3D?device. This constant works on Microsoft Windows?2000 and Windows XP only.
D3DPRESENTFLAG_VIDEO0x00000010This is a hint to the driver that the back buffers will contain video data.

These constants are used by D3DPRESENT_PARAMETERS.

Constant Information

Headerd3d9types.h
Minimum operating systemWindows 98


© 2002 Microsoft Corporation. All rights reserved.