DDGPESurf Constructors (Windows Embedded CE 6.0)

1/6/2010

The DDGPESurf object has overridden several of the GPESurf object's constructors in order to add functionality.

DDGPESurf(
  int width, 
  int height, 
  void* pBits, 
  int stride, 
  EGPEFormat format
);
DDGPESurf(
  int width, 
  int height, 
  void* pBits, 
  int stride, 
  EGPEFormat format, 
  EDDGPEPixelFormat pixelFormat
);
DDGPESurf(
  int width, 
  int height, 
  int stride, 
  EGPEFormat format, 
  EDDGPEPixelFormat pixelFormat
);
DDGPESurf(
  int width, 
  int height, 
  EGPEFormat format 
);

Parameters

• width
  Requested width for the surface, in pixels.

• height
  Requested height for the surface, in pixels.

• pBits
  Pointer allocated for the surface's graphic data. If the pBits parameter is not passed into the constructor, the DDGPESurf object allocates system memory for that surface's data.

• stride
  Requested stride for the surface.

• format
  Requested format for the surface.

• pixelFormat
  Requested pixel format for the surface.

Return Values

None.

Remarks

When your driver creates a surface, it should never create a DDGPESurf object directly. Instead, you should define your own surface object that derives from DDGPESurf. To add hardware-specific or driver-specific functionality, you can add new constructors and possibly override one or more of the existing constructors.

If your surface object calls one of the DDGPESurf constructors without supplying a pointer to memory that has been allocated for the surface's graphic information, DDGPESurf will automatically allocate system memory for you. The DDGPESurf destructor will free any memory allocated by the DDGPESurf constructors.

Requirements

See Also

Concepts

DDGPESurf Class
DDGPESurf Class Definition