IDirect3DDevice8::GetBackBuffer
This method retrieves a back buffer from the device's swap chain.
HRESULT GetBackBuffer(
UINT BackBuffer,
D3DBACKBUFFER_TYPE Type,
IDirect3DSurface8** 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] Stereo view is not supported in DirectX 8.0, so the only valid value for this parameter is D3DBACKBUFFER_TYPE_MONO. - ppBackBuffer
[out, retval] Address of a pointer to an IDirect3DSurface8 interface, representing the returned back buffer surface.
Return Values
If the method succeeds, the return value is D3D_OK.
If BackBuffer exceeds or equals the total number of back buffers, then the function fails and returns D3DERR_INVALIDCALL.
Remarks
Calling this method will increase the internal reference count on the IDirect3DSurface8 interface. Failure to call IUnknown::Release when finished using this IDirect3DSurface8 interface results in a memory leak.
Requirements
OS Versions: Windows CE .NET 4.0 and later.
Header: D3d8.h.
Link Library: D3d8.lib.
See Also
IDirect3DSurface8 | IUnknown::Release | IDirect3DDevice8
Last updated on Thursday, April 08, 2004
© 1992-2003 Microsoft Corporation. All rights reserved.