Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.
A version of this page is also available for
4/8/2010

This structure describes the properties of a swap chain.

Syntax

typedef struct _D3DMPRESENT_PARAMETERS_ {
  UINT				 
BackBufferWidth;
  UINT				 
BackBufferHeight;
  D3DMFORMAT		 
BackBufferFormat;
  UINT				 
BackBufferCount;
  D3DMMULTISAMPLE_TYPE 
MultiSampleType;
  D3DMSWAPEFFECT	 
SwapEffect;
  BOOL				 
Windowed;
  BOOL				 
EnableAutoDepthStencil;
  D3DMFORMAT		 
AutoDepthStencilFormat;
  ULONG			
Flags;
  UINT				 
FullScreen_PresentationInterval;
} D3DMPRESENT_PARAMETERS;

Members

BackBufferWidth

A UINT value representing the width of the back buffer in pixels.

BackBufferHeight

A UINT value representing the height of the back buffer in pixels.

BackBufferFormat

A D3DMFORMATenumeration value representing the back buffer's pixel format.

BackBufferCount

A UINT value representing the number of back buffers in the swap chain. There must always be at least one back buffer. If zero back buffers are requested the Direct3D Mobile middleware will override the setting with a default value of one. Multiple back buffers are useful to allow the system to rasterize at the same time it is waiting for a vertical retrace to present the previous frame.

MultiSampleType

A D3DMMULTISAMPLE_TYPEenumeration value indicating the type of multi-sample antialiasing that should be performed as part of the presentation process.

SwapEffect

A D3DMSWAPEFFECTenumeration value describing how the data from the back buffers should be transferred to the front buffer.

Windowed

A Boolean value defining the cooperative level for the window. The value TRUE indicates windowed cooperative level, and the value FALSE indicates full screen cooperative level.

EnableAutoDepthStencil

A Boolean value defining whether a depth or stencil buffer should be created with the swap chain. Set this value to TRUE to create the depth stencil buffer and FALSE to prevent creating it.

AutoDepthStencilFormat

A D3DMFORMATenumeration value representing the pixel format of the depth or stencil buffer.

Flags

Set this member to 0 or to D3DMPRESENTFLAG_LOCKABLE_BACKBUFFER.

FullScreen_PresentationInterval

A UINT value defining the number of vertical refresh intervals to wait before presenting the back buffer. Set this value to one of the D3DMPRESENT Values.

Requirements

Header d3dmtypes.h
Windows Embedded CE Windows CE 5.0 and later
Windows Mobile Windows Mobile Version 5.0 and later

See Also