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 |