共用方式為

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

ddckCKDestBlt成員有效。

DDSD_CKDESTOVERLAY

ddckCKDestOverlay成員有效。

DDSD_CKSRCBLT

ddckCKSrcBlt成員有效。

DDSD_CKSRCOVERLAY

ddckCKSrcOverlay成員有效。

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

N/A

DUMMYUNIONNAMEN.lPitch

指定兩個相鄰掃描行開頭之間的位元組數目;也就是說，要新增至一個掃描行開頭位址的位元組數目，以到達下一個掃描行下方的開始位址。 驅動程式的 DdCreateSurface 回呼必須傳回此值。

DUMMYUNIONNAMEN.dwLinearSize

指定無格式、晚期配置、優化介面的大小以位元組為單位。

dwBackBufferCount

指定與介面相關聯的後端緩衝區數目。

DUMMYUNIONNAMEN.dwMipMapCount

指定 mipmap 層級的數目。

DUMMYUNIONNAMEN.dwZBufferBitDepth

指定每個圖元位的 z 緩衝區深度。

DUMMYUNIONNAMEN.dwRefreshRate

指定) 描述顯示模式時，監視器 (的重新整理速率。

dwAlphaBitDepth

指定每個圖元位的 Alpha 緩衝區深度。

dwReserved

保留 ，且 應設定為零。

lpSurface

指定相關聯表面記憶體的位址。

ddckCKDestOverlay

指定目的地重迭使用的色彩索引鍵。

ddckCKDestBlt

指定目的地 blt 使用的色彩索引鍵。

ddckCKSrcOverlay

指定來源重迭使用的色彩索引鍵。

ddckCKSrcBlt

指定來源 blt 使用的色彩索引鍵。

ddpfPixelFormat

指定描述表面像素格式的 DDPIXELFORMAT 結構。

ddsCaps

指定包含 Microsoft DirectDrawMicrosoft 介面功能的 DDSCAPS 結構。

備註

每個潛在表面類型的相關成員都不同。 此結構通常是由應用程式建立和初始化。

需求

   
標頭 ddraw.h

另請參閱