DDGPE::AllocBackBuffer (Windows Embedded CE 6.0)

1/6/2010

This method is a special case allocator for creating back buffers for the primary surface. These must be clones of the primary surface, as they may be flipped and become the primary.

Syntax

virtual SCODE AllocBackBuffer(
  LPDDRAWI_DDRAWSURFACE_LCL lpDDSurface
);

Parameters

• lpDDSurface
  Pointer to an existing DirectDraw surface object that will be associated with the backbuffer surface that is allocated.

Return Value

The return value is S_OK, if the function is successful. Otherwise, an error code is returned.

Remarks

AllocBackBuffer is called by DDGPECreateSurface to allocate back buffers for the primary surface. AllocBackBuffer must return a buffer that is identical to the primary surface buffer, as this buffer may be flipped and become the primary surface buffer.

This function uses the AllocSurface() function call with the primary surface parameters, and the flag GPE_BACK_BUFFER to indicate this surface is going to be used as a back buffer.

Requirements

See Also

Reference

DDGPE::AllocSurface
DDGPE::AllocVideoSurface

Concepts

DDGPE Class
DDGPE Class Definition