IDirect3DSwapChain9::GetFrontBufferData method (d3d9.h)

Generates a copy of the swapchain's front buffer and places that copy in a system memory buffer provided by the application.


HRESULT GetFrontBufferData(
  [in, out] IDirect3DSurface9 *pDestSurface


[in, out] pDestSurface

Type: IDirect3DSurface9*

Pointer to an IDirect3DSurface9 interface that will receive a copy of the swapchain's front buffer. The data is returned in successive rows with no intervening space, starting from the vertically highest row to the lowest. For windowed mode, the size of the destination surface should be the size of the desktop. For full screen mode, the size of the destination surface should be the screen size.

Return value


If the method succeeds, the return value is D3D_OK. If BackBuffer exceeds or equals the total number of back buffers, the function fails and returns D3DERR_INVALIDCALL.


Calling this method will increase the internal reference count on the IDirect3DSurface9 interface. Failure to call IUnknown::Release when finished using this IDirect3DSurface9 interface results in a memory leak.


Target Platform Windows
Header d3d9.h (include D3D9.h)
Library D3D9.lib

See also