D3DMPRESENT_PARAMETERS

A version of this page is also available for

Windows Embedded CE 6.0 R3

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 D3DMFORMAT enumeration 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_TYPE enumeration value indicating the type of multi-sample antialiasing that should be performed as part of the presentation process.

• SwapEffect
  A D3DMSWAPEFFECT enumeration 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 D3DMFORMAT enumeration 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

See Also

Reference

Direct3D Mobile Structures