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 構造体のメンバーに有効なデータが含まれているかどうかを判別するフラグのセットを指定します。 このメンバーには、次のフラグを 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_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

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

DUMMYUNIONNAMEN.dwLinearSize

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

dwBackBufferCount

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

DUMMYUNIONNAMEN.dwMipMapCount

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

DUMMYUNIONNAMEN.dwZBufferBitDepth

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

DUMMYUNIONNAMEN.dwRefreshRate

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

dwAlphaBitDepth

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

dwReserved

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

lpSurface

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

ddckCKDestOverlay

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

ddckCKDestBlt

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

ddckCKSrcOverlay

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

ddckCKSrcBlt

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

ddpfPixelFormat

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

ddsCaps

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

解説

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

要件

   
Header ddraw.h

関連項目