Microsoft DirectX 9.0

DDSURFACEDESC Structure

The structure is passed to CreateSurface to describe the surface that should be created. The relevant members differ for each type of surface being created.

typedef struct _DDSURFACEDESC{
  DWORD   dwSize;
  DWORD   dwFlags;
  DWORD   dwHeight;
  DWORD   dwWidth;
  LONG    lPitch;
  DWORD   dwBackBufferCount;
  DWORD   dwZBufferBitDepth;
  DWORD   dwAlphaBitDepth;
  LPVOID  lpSurface;
  DDCOLORKEY  ddckCKDestOverlay;
  DDCOLORKEY  ddckCKDestBlt;
  DDCOLORKEY  ddckCKSrcOverlay;
  DDCOLORKEY  ddckCKSrcBlt;
  DDPIXELFORMAT  ddpfPixelFormat;
  DDSCAPS  ddsCaps;
} DDSURFACEDESC,  FAR* LPDDSURFACEDESC;

Members

dwSize

Size of the structure. Must be initialized prior to use.

dwFlags

Flag Description
DDSD_DDSCAPS ddsCaps is valid.
DDSD_HEIGHT dwHeight is valid.
DDSD_WIDTH dwWidth is valid.
DDSD_PITCH lPitch is valid.
DDSD_BACKBUFFERCOUNT dwBackBufferCount is valid.
DDSD_ZBUFFERBITDEPTH dwZBufferBitDepth is valid.
DDSD_ALPHABITDEPTH dwAlphaBitDepth is valid.
DDSD_LPSURFACE lpSurface is valid.
DDSD_PIXELFORMAT ddpfPixelFormat is valid.
DDSD_CKDESTOVERLAY ddckCKDestOverlay is valid.
DDSD_CKDESTBLT ddckCKDestBlt is valid.
DDSD_CKSRCOVERLAY ddckCKSrcOverlay is valid.
DDSD_CKSRCBLT ddckCKSrcBlt is valid.
DDSD_ALL All members are 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.

dwZBufferBitDepth

Depth of Z buffer.

dwAlphaBitDepth

Depth of alpha buffer.

lpSurface

Pointer to 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.

See Also