Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.
A version of this page is also available for
4/8/2010

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

Syntax 

HRESULT GetFrontBuffer(
  IDirect3DMobileSurface** 
pFrontBuffer
);

Parameters

pFrontBuffer

[in] Pointer to an IDirect3DMobileSurfaceinterface 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 Value

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

The buffer pointed to by pDestSurfacewill be filled with a representation of the front buffer. The destination buffer should be the same size and format as the front buffer. An application can determine the size and format of the front buffer by calling IDirect3DMobileDevice::GetDisplayMode.

Requirements

Header d3dm.h
Library D3dm.lib, D3dmguid.lib
Windows Embedded CE Windows CE 5.0 and later
Windows Mobile Windows Mobile Version 5.0 and later

See Also