DDSURFACEDESC 结构 (ddraw.h)

  • 项目

DDSURFACEDESC 结构包含驱动程序要创建的图面的说明。

语法

typedef struct _DDSURFACEDESC {
  DWORD         dwSize;
  DWORD         dwFlags;
  DWORD         dwHeight;
  DWORD         dwWidth;
#if ...
  union {
    LONG  lPitch;
    DWORD dwLinearSize;
  } DUMMYUNIONNAMEN;
  DWORD         dwBackBufferCount;
#else
  union {
    DWORD dwMipMapCount;
    DWORD dwZBufferBitDepth;
    DWORD dwRefreshRate;
  } DUMMYUNIONNAMEN;
#endif
  DWORD         dwAlphaBitDepth;
  DWORD         dwReserved;
  LPVOID        lpSurface;
  DDCOLORKEY    ddckCKDestOverlay;
  DDCOLORKEY    ddckCKDestBlt;
  DDCOLORKEY    ddckCKSrcOverlay;
  DDCOLORKEY    ddckCKSrcBlt;
  DDPIXELFORMAT ddpfPixelFormat;
  DDSCAPS       ddsCaps;
} *LPDDSURFACEDESC, DDSURFACEDESC;

成员

dwSize

指定此 DDSURFACEDESC 结构的大小（以字节为单位）。 在使用 结构之前，必须初始化此成员。

dwFlags

指定一组标志，用于确定 DDSURFACEDESC 结构的哪些成员包含有效数据。 此成员可以是以下一个或多个标志：

标志 含义

DDSD_ALL

所有输入成员都包含有效数据。

DDSD_ALPHABITDEPTH

dwAlphaBitDepth 成员有效。

DDSD_BACKBUFFERCOUNT

dwBackBufferCount 成员有效。

DDSD_CAPS

ddsCaps 成员有效。

DDSD_CKDESTBLT

ddckDestBlt 成员有效。

DDSD_CKDESTOVERLAY

ddckDestOverlay 成员有效。

DDSD_CKSRCBLT

ddckSrcBlt 成员有效。

DDSD_CKSRCOVERLAY

ddckSrcOverlay 成员有效。

DDSD_HEIGHT

dwHeight 成员有效。

DDSD_LINEARSIZE

dwLinearSize 成员有效。

DDSD_MIPMAPCOUNT

dwMipMapCount 成员有效。

DDSD_PITCH

lPitch 成员有效。

DDSD_PIXELFORMAT

ddpfPixelFormat 成员有效。

DDSD_REFRESHRATE

dwRefreshRate 成员有效。

DDSD_WIDTH

dwWidth 成员有效。

DDSD_ZBUFFERBITDEPTH

dwZBufferBitDepth 成员有效。

dwHeight

指定图面的高度（以像素为单位）。

dwWidth

指定图面的宽度（以像素为单位）。

DUMMYUNIONNAMEN

不适用

DUMMYUNIONNAMEN.lPitch

指定两个相邻扫描行的开头之间的字节数;也就是说，要添加到一个扫描行的起始地址以到达其下方下一个扫描行的起始地址的字节数。 驱动程序的 DdCreateSurface 回调必须返回此值。

DUMMYUNIONNAMEN.dwLinearSize

指定无格式、后期分配的优化图面的大小（以字节为单位）。

dwBackBufferCount

指定与图面关联的后台缓冲区数。

DUMMYUNIONNAMEN.dwMipMapCount

指定 mipmap 级别的数目。

DUMMYUNIONNAMEN.dwZBufferBitDepth

指定 z 缓冲区的深度（以每像素位为单位）。

DUMMYUNIONNAMEN.dwRefreshRate

指定在描述显示模式) 时使用的监视器 (的刷新率（以赫为单位）。

dwAlphaBitDepth

指定 alpha 缓冲区的深度（以每像素位数为单位）。

dwReserved

保留，应设置为零。

lpSurface

指定关联 Surface 内存的地址。

ddckCKDestOverlay

指定目标覆盖使用的颜色键。

ddckCKDestBlt

指定目标 blt 使用的颜色键。

ddckCKSrcOverlay

指定源覆盖使用的颜色键。

ddckCKSrcBlt

指定源 blt 使用的颜色键。

ddpfPixelFormat

指定描述图面像素格式的 DDPIXELFORMAT 结构。

ddsCaps

指定包含 Microsoft DirectDrawMicrosoft 图面功能的 DDSCAPS 结构。

备注

每种潜在类型的图面的相关成员各不相同。 此结构通常由应用程序创建和初始化。

要求

   
标头 ddraw.h

请参阅