DDSURFACEDESC2

The DDSURFACEDESC2 type contains a description of a surface. This type is passed to the DirectDraw7.CreateSurface method. The relevant members differ for each potential type of surface.

Type DDSURFACEDESC2
    ddckCKDestBlt As DDCOLORKEY
    ddckCKDestOverlay As DDCOLORKEY
    ddckCKSrcBlt As DDCOLORKEY
    ddckCKSrcOverlay As DDCOLORKEY
    ddpfPixelFormat As DDPIXELFORMAT
    ddsCaps As DDSCAPS2
    lAlphaBitDepth As Long
    lBackBufferCount As Long
    lFlags As CONST_DDSURFACEDESCFLAGS
    lHeight As Long
    lLinearSize As Long
    lMipMapCount As Long
    lPitch As Long
    lRefreshRate As Long
    lTextureStage As Long
    lWidth As Long
    lZBufferBitDepth As Long
End Type

Members

ddckCKDestBlt

DDCOLORKEY type that describes the destination color key for blit operations.

ddckCKDestOverlay

DDCOLORKEY type that describes the destination color key to be used for an overlay surface.

ddckCKSrcBlt

DDCOLORKEY type that describes the source color key for blit operations.

ddckCKSrcOverlay

DDCOLORKEY type that describes the source color key to be used for an overlay surface.

ddpfPixelFormat

DDPIXELFORMAT type that describes the surface's pixel format.

ddsCaps

DDSCAPS2 type that contains the capabilities of the surface.

lAlphaBitDepth

Depth of alpha buffer.

lBackBufferCount

Number of back buffers.

lFlags

Optional control flags. One or more of the constants of the CONST_DDSURFACEDESCFLAGS enumeration.

lHeight and lWidth

Dimensions of the surface to be created, in pixels.

lLinearSize

Not currently used.

lMipMapCount

Number of mipmap levels.

lPitch

Distance, in bytes, to the start of next line. When used with the DirectDrawSurface7.GetSurfaceDesc method, this is a return value. When creating a surface from existing memory, this is an input value that must be a multiple.

lRefreshRate

Refresh rate (used when the display mode is described). The value of 0 indicates an adapter default.

lTextureStage

Stage identifier used to bind a texture to a specific stage in the multitexture cascade of a 3-D device. Although not required for all hardware, setting this member is recommended for best performance on the largest variety of 3-D accelerators. Hardware that requires explicitly assigned textures exposes the D3DDEVCAPS_SEPARATETEXTUREMEMORIES 3-D device capability in the D3DDEVICEDESC structure that is filled by the Direct3DDevice7.GetCaps method.

lZBufferBitDepth

Depth of z-buffer; 32-bit z-buffers are not supported.

Remarks

The lPitch member is an output values when calling the DirectDrawSurface7.GetSurfaceDesc method. When creating surfaces from existing memory, or updating surface characteristics, these members are input values that describe the pitch and location of memory allocated by the calling application for use by DirectDraw. DirectDraw does not attempt to manage or free memory allocated by the application. For more information, see Creating Client Memory Surfaces and Updating Surface Characteristics.