Share via


DDGPESurf::SetDDGPESurf (Windows Embedded CE 6.0)

1/6/2010

This method associates the current DDGPESurf object with a DirectDraw surface.

Syntax

virtual void SetDDGPESurf(
  LPDDRAWI_DDRAWSURFACE_LCL lpDDSurface 
);

Parameters

  • lpDDSurface
    A pointer to an existing DirectDraw surface. The DDGPESurf object is associated with it. Any existing DDGPESurf object associated with this surface is replaced. The driver is responsible for managing surfaces replaced in this manner.

Return Value

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

Remarks

Use this method to associate a known DDGPESurf object with a DirectDraw surface with no associated surface data. Avoid associating a single DDGPESurf object with more than one distinct DirectDraw surface. Your driver is required to set up the appropriate DirectDraw surface attributes.

Requirements

Header ddgpe.h
Library Ddgpe.lib
Windows Embedded CE Windows Embedded CE 6.0 and later

See Also

Concepts

DDGPESurf Class
DDGPESurf Class Definition