Microsoft DirectX 8.1 (C++)

IDirect3DSwapChain8::GetBackBuffer

Retrieves a back buffer from the swap chain of the device.

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.1, 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.

Note 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

Header: Declared in D3d8.h.
Import Library: Use D3d8.lib.