DDSURFACEDESC

typedef struct _DDSURFACEDESC{

DWORD dwSize;

DWORD dwFlags;

DWORD dwHeight;

DWORD dwWidth;

LONG lPitch;

DWORD dwBackBufferCount;

union

{

DWORD dwMipMapCount;

DWORD dwZBufferBitDepth;

DWORD dwRefreshRate;

};

DWORD dwAlphaBitDepth;

DWORD dwReserved;

LPVOID lpSurface;

DDCOLORKEY ddckCKDestOverlay;

DDCOLORKEY ddckCKDestBlt;

DDCOLORKEY ddckCKSrcOverlay;

DDCOLORKEY ddckCKSrcBlt;

DDPIXELFORMAT ddpfPixelFormat;

DDSCAPS ddsCaps;

} DDSURFACEDESC, FAR* LPDDSURFACEDESC;

Contains a description of the surface to be created. This structure is passed to the IDirectDraw2::CreateSurface method. The relevant members differ for each potential type of surface.

dwSize

Size of the structure. This member must be initialized before the structure is used.

dwFlags

Optional control flags. One or more of the following flags:

DDSD_ALL

Indicates that all input members are valid.

DDSD_ALPHABITDEPTH

Indicates that the dwAlphaBitDepth member is valid.

DDSD_BACKBUFFERCOUNT

Indicates that the dwBackBufferCount member is valid.

DDSD_CAPS

Indicates that the ddsCaps member is valid.

DDSD_CKDESTBLT

Indicates that the ddckCKDestBlt member is valid.

DDSD_CKDESTOVERLAY

Indicates that the ddckCKDestOverlay member is valid.

DDSD_CKSRCBLT

Indicates that the ddckCKSrcBlt member is valid.

DDSD_CKSRCOVERLAY

Indicates that the ddckCKSrcOverlay member is valid.

DDSD_HEIGHT

Indicates that the dwHeight member is valid.

DDSD_MIPMAPCOUNT

Indicates that the dwMipMapCount member is valid.

DDSD_PITCH

Indicates that the lPitch member is valid.

DDSD_PIXELFORMAT

Indicates that the ddpfPixelFormat member is valid.

DDSD_REFRESHRATE

Indicates that the dwRefreshRate member is valid.

DDSD_WIDTH

Indicates that the dwWidth member is valid.

DDSD_ZBUFFERBITDEPTH

Indicates that the dwZBufferBitDepth member is valid.

dwHeight

Height of surface.

dwWidth

Width of input surface.

lPitch

Distance to start of next line (return value only).

dwBackBufferCount

Number of back buffers.

dwMipMapCount

Number of mipmap levels.

dwZBufferBitDepth

Depth of z-buffer.

dwRefreshRate

Refresh rate (used when the display mode is described).

dwAlphaBitDepth

Depth of alpha buffer.

dwReserved

Reserved.

lpSurface

Address of the associated surface memory.

ddckCKDestOverlay

Color key for destination overlay use.

ddckCKDestBlt

Color key for destination blit use.

ddckCKSrcOverlay

Color key for source overlay use.

ddckCKSrcBlt

Color key for source blit use.

ddpfPixelFormat

Pixel format description of the surface.

ddsCaps

DirectDraw surface capabilities.