DDSURFACEDESC2構造体 (ddraw.h)

DDSURFACEDESC2構造体には、ドライバーによって作成されるサーフェスの説明が含まれています。

構文

typedef struct _DDSURFACEDESC2 {
  DWORD      dwSize;
  DWORD      dwFlags;
  DWORD      dwHeight;
  DWORD      dwWidth;
#if ...
  union {
    LONG  lPitch;
    DWORD dwLinearSize;
  } DUMMYUNIONNAMEN;
#elif
  union {
    DWORD dwBackBufferCount;
    DWORD dwDepth;
  } DUMMYUNIONNAMEN;
#elif
  union {
    DWORD dwMipMapCount;
    DWORD dwRefreshRate;
    DWORD dwSrcVBHandle;
  } DUMMYUNIONNAMEN;
  DWORD      dwAlphaBitDepth;
  DWORD      dwReserved;
  LPVOID     lpSurface;
#elif
  union {
    DDCOLORKEY ddckCKDestOverlay;
    DWORD      dwEmptyFaceColor;
  } DUMMYUNIONNAMEN;
  DDCOLORKEY ddckCKDestBlt;
  DDCOLORKEY ddckCKSrcOverlay;
  DDCOLORKEY ddckCKSrcBlt;
#else
  union {
    DDPIXELFORMAT ddpfPixelFormat;
    DWORD         dwFVF;
  } DUMMYUNIONNAMEN;
#endif
  DDSCAPS2   ddsCaps;
  DWORD      dwTextureStage;
} *LPDDSURFACEDESC2, DDSURFACEDESC2;

メンバー

dwSize

このDDSURFACEDESC2構造体のサイズをバイト単位で指定します。 構造体を使用する前に、このメンバーを初期化する必要があります。

dwFlags

有効なデータを含むDDSURFACEDESC2構造体のメンバーを決定するフラグのセットを指定します。 このメンバーには、次のフラグを 1 つ以上指定できます。

フラグ	説明
DDSD_ALL	すべての入力メンバーに有効なデータが含まれています。
DDSD_ALPHABITDEPTH	dwAlphaBitDepth メンバーは有効です。
DDSD_BACKBUFFERCOUNT	dwBackBufferCount メンバーは有効です。
DDSD_CAPS	ddsCaps メンバーは有効です。
DDSD_CKDESTBLT	ddckCKDestBlt メンバーは有効です。
DDSD_CKDESTOVERLAY	ddckCKDestOverlay メンバーは有効です。
DDSD_CKSRCBLT	ddckCKSrcBlt メンバーは有効です。
DDSD_CKSRCOVERLAY	ddckCKSrcOverlay メンバーは有効です。
DDSD_FVF	dwFVF メンバーは有効です。
DDSD_HEIGHT	dwHeight メンバーは有効です。
DDSD_LINEARSIZE	dwLinearSize メンバーは有効です。
DDSD_LPSURFACE	lpSurface メンバーは有効です。
DDSD_MIPMAPCOUNT	dwMipMapCount メンバーは有効です。
DDSD_PITCH	lPitch メンバーは有効です。
DDSD_PIXELFORMAT	ddpfPixelFormat メンバーは有効です。
DDSD_REFRESHRATE	dwRefreshRate メンバーは有効です。
DDSD_SRCVBHANDLE	dwSrcVBHandle メンバーは有効です。
DDSD_TEXTURESTAGE	dwTextureStage メンバーは有効です。
DDSD_WIDTH	dwWidth メンバーは有効です。
DDSD_ZBUFFERBITDEPTH	このフラグは、DDSURFACEDESC2では使用されません。 DDSURFACEDESC でのみ使用されます。

dwHeight

サーフェスの高さをピクセル単位で指定します。

dwWidth

サーフェスの幅をピクセル単位で指定します。

DUMMYUNIONNAMEN

該当なし

DUMMYUNIONNAMEN.lPitch

隣接する 2 つのスキャン行の先頭の間のバイト数を指定します。つまり、1 つのスキャン行の先頭アドレスに追加して、その下の次のスキャン行の開始アドレスに到達するバイト数です。 ドライバーの DdCreateSurface コールバックは、この値を返す必要があります。

DUMMYUNIONNAMEN.dwLinearSize

フォームレス、遅延割り当て、最適化されたサーフェスのサイズをバイト単位で指定します。

DUMMYUNIONNAMEN.dwBackBufferCount

サーフェスに関連付けられているバック バッファーの数を指定します。

DUMMYUNIONNAMEN.dwDepth

ボリューム テクスチャの場合のビット深度。

DUMMYUNIONNAMEN.dwMipMapCount

ミップマップ レベルの数を指定します。

DUMMYUNIONNAMEN.dwRefreshRate

モニターのリフレッシュ レートをヘルツ単位で指定します (表示モードが説明されている場合に使用されます)。

DUMMYUNIONNAMEN.dwSrcVBHandle

IDirect3DVertexBuffer7::Optimize で使用されるソースを指定します (Microsoft Direct3D SDK ドキュメントで説明されています)。

dwAlphaBitDepth

アルファ バッファーの深さをピクセルあたりのビット数で指定します。

dwReserved

予約済みで、 を 0 に設定する必要があります。

lpSurface

関連付けられているサーフェス メモリのアドレスを指定します。

DUMMYUNIONNAMEN.ddckCKDestOverlay

コピー先オーバーレイで使用するカラー キーを指定します。

DUMMYUNIONNAMEN.dwEmptyFaceColor

空のキューブ マップ面の物理色を指定します。

ddckCKDestBlt

コピー先の blit で使用するカラー キーを指定します。

ddckCKSrcOverlay

ソース オーバーレイで使用するカラー キーを指定します。

ddckCKSrcBlt

ソース blit で使用するカラー キーを指定します。

DUMMYUNIONNAMEN.ddpfPixelFormat

サーフェスのピクセル形式を記述する DDPIXELFORMAT 構造体を指定します。

DUMMYUNIONNAMEN.dwFVF

頂点バッファーのフレキシブル頂点形式 (D3DFVF) を指定します。

ddsCaps

DirectDraw サーフェス機能を含む DDSCAPS 構造体を指定します。

dwTextureStage

マルチテキスト のカスケード内のステージを指定します。 詳細については、「 テクスチャ ステージ」を参照してください。

注釈

関連するメンバーは、サーフェスの潜在的な種類ごとに異なります。 この構造体は、通常、アプリケーションによって作成および初期化されます。

要件

要件	値
Header	ddraw.h

こちらもご覧ください

• DdCreateSurface
• DDPIXELFORMAT
• DDSCAPS