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 |