IDirect3DMobileDevice::GetBackBuffer (Windows CE 5.0)
This method retrieves a back buffer from the device's swap chain.
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. If BackBuffer exceeds or equals the total number of back buffers, the method fails with D3DMERR_INVALIDCALL. - Type
[in] A D3DMBACKBUFFER_TYPE value. - ppBackBuffer
[out] Address of a pointer to an IDirect3DMobileSurface interface that represents the returned back buffer surface.
Return Values
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 IDirect3DMobileSurface interface. Failure to call IUnknown::Release when finished using this IDirect3DMobileSurface interface results in a memory leak.
Requirements
OS Versions: Windows CE 5.0 and later.
Header: D3dm.h.
Link Library: D3dm.lib, D3dmguid.lib.
See Also
IDirect3DMobileDevice | D3DMBACKBUFFER_TYPE | IDirect3DMobileSurface
Send Feedback on this topic to the authors