The DDSURFACEDESC structure 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.
typedef struct _DDSURFACEDESC {
DWORD dwSize;
DWORD dwFlags;
DWORD dwHeight;
DWORD dwWidth;
union
{
LONG lPitch;
DWORD dwLinearSize;
};
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;
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_LINEARSIZE | |
Not used. | |
DDSD_LPSURFACE | |
Indicates that the lpSurface 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. |
Windows NT: Use version 4.0 or later.
Windows: Use Windows 95 or later. Available as a redistributable for Windows 95.
Windows CE: Unsupported.
Header: Declared in ddraw.h.