Share via


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

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

See Also

Concepts

DDGPESurf Class
DDGPESurf Class Definition