Share via


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

  • 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

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

See Also

Reference

DDGPEStandardHeader

Concepts

DDGPE Data Structures, Types, and Constants