DDGPEAllocSurfaceData (Windows Embedded CE 6.0)

1/6/2010

This section shows the definition of the DDGPEAllocSurfaceData structure.

Syntax

#define DDGPEALLOCSURFACEDATA_VERSION0(0)
#define DDGPEALLOCSURFACEDATA_CURRENTVERSION 
(DDGPEBLTPARMS_VERSION0)
struct DDGPEAllocSurfaceData{
  DDGPEStandardHeader; 
  DWORD dwCreateFlags; 
  int nWidth; 
  int nHeight; 
  int nStride; 
  int nSurfaceFlags; 
  unsigned char* pBits; 
  EGPEFormat gpeFormat; 
  EDDGPEPixelFormat* ddgpePixelFormat 
}

Members

• DDGPEStandardHeader
  See DDGPEStandardHeader for more information.

• dwCreateFlags
  Driver-specific surface creation flags that must be passed to driver's surface allocation implementation.

• nWidth
  The desired width of the surface.

• nHeight
  The desired height of the surface.

• nStride
  The desired stride of the surface.

• nSurfaceFlags
  GPE surface flags for the surface.

  Flag	Description
  GPE_REQUIRE_VIDEO_MEMORY	Surface memory must be allocated in video memory.
  GPE_PREFER_VIDEO_MEMORY	Surface memory should be allocated in video memory if possible, but can be allocated in system memory, if necessary.

  If no flags are set, for example, surfaceFlags is set to zero (0), the surface is allocated in system memory.

• pBits
  A pointer to an existing block of video or system memory that is used to store the surface's data.

• gpeFormat
  The desired GPE format of the surface.

• ddgpePixelFormat
  The desired DDGPE pixel format of the surface.

Requirements

See Also

Reference

DDGPEStandardHeader

Concepts

DDGPE Data Structures, Types, and Constants