IDirect3DDevice8::GetFrontBuffer

This method generates a copy of the device's front buffer and places that copy in a system memory buffer provided by the application.

HRESULT GetFrontBuffer(
  IDirect3DSurface8* pDestSurface
);

Parameters

• pDestSurface
  [in] Pointer to an IDirect3DSurface8 interface that will receive a copy of the contents of the front buffer. The data is returned in successive rows with no intervening space, starting from the vertically highest row on the device's output to the lowest.

Return Values

If the method succeeds, the return value is D3D_OK.

If the method fails, the return value can be one of the following values:

• D3DERR_DEVICELOST
• D3DERR_INVALIDCALL

Remarks

The buffer pointed to by pDestSurface will be filled with a representation of the front buffer, converted to the standard 32bpp format, D3DFMT_A8R8G8B8.

For more information, see Lost Devices and Retrieved Data.

Requirements

OS Versions: Windows CE .NET 4.0 and later.
Header: D3d8.h.
Link Library: D3d8.lib.

See Also

Lost Devices and Retrieved Data | IDirect3DSurface8 | IDirect3DDevice8

 Last updated on Thursday, April 08, 2004

© 1992-2003 Microsoft Corporation. All rights reserved.