 Important: |
|---|
| This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist. |
This section shows the definition of the DDGPEAllocSurfaceDatastructure. It then describes the meaning of each field, and gives you information about how you can use it in your driver.
#define DDGPEALLOCSURFACEDATA_VERSION0(0) #define
DDGPEALLOCSURFACEDATA_CURRENTVERSION \ (DDGPEBLTPARMS_VERSION0)
struct DDGPEAllocSurfaceData { // for expansion
DDGPEStandardHeader; DWORD dwCreateFlags; int nWidth; int nHeight;
int nStride; int nSurfaceFlags; unsigned char *pBits; EGPEFormat
gpeFormat; EDDGPEPixelFormat *ddgpePixelFormat; }
DDGPEStandardHeader
See DDGPEStandardHeaderfor more information.
dwCreateFlags
This field can contain driver-specific surface creation flags that need to 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.
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 (i.e. surfaceFlags is set to zero (0)), the surface will be allocated in system memory.
pBits
A pointer to an existing block of video or system memory that will be used to store the surface's data.
gpeFormat
The desired GPEformat of the surface.
ddgpePixelFormat
The desired DDGPEpixel format of the surface.
Last updated on Tuesday, July 13, 2004