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 method retrieves a back buffer from the swap chain of the device.

Syntax 

HRESULT GetBackBuffer(
  UINT 
BackBuffer,
  D3DMBACKBUFFER_TYPE 
Type,
  IDirect3DMobileSurface** 
ppBackBuffer
);

Parameters

BackBuffer

[in] Index of the back buffer object to return. Back buffers are numbered from 0 to the total number of back buffers - 1. A value of 0 returns the first back buffer, not the front buffer. The front buffer is not accessible through this method.

Type

[in] The only valid value for this parameter is D3DMBACKBUFFER_TYPE_MONO (see D3DMBACKBUFFER_TYPE).

ppBackBuffer

[out] Address of a pointer to an IDirect3DMobileSurfaceinterface that represents the returned back buffer surface.

Return Value

If the method succeeds, the return value is D3DM_OK (see D3DM Values).

If the method fails, the return value can be D3DMERR_INVALIDCALL (see D3DMERR Values).

Remarks

Calling this method will increase the internal reference count on the IDirect3DMobileSurfaceinterface. Failure to call IUnknown::Releasewhen finished using this IDirect3DMobileSurfaceinterface results in a memory leak.

Requirements

Header d3dm.h
Library D3dm.lib, D3dmguid.lib
Windows Embedded CE Windows CE 5.0 and later
Windows Mobile Windows Mobile Version 5.0 and later

See Also