DDSCAPS 構造体 (ddraw.h)

[アーティクル]
03/16/2023

DDSCAPS 構造体は、Microsoft DirectDraw サーフェスオブジェクトの機能を定義します。

構文

typedef struct _DDSCAPS {
  DWORD dwCaps;
} DDSCAPS;

メンバー

dwCaps

サーフェスの機能を指定するフラグのセットを示します。このメンバーは、次のいずれかのフラグのビットごとの OR です。

フラグ	説明
DDSCAPS_3DDEVICE	このサーフェスは、3D レンダリングに使用できます。アプリケーションでは、このフラグを使用して、特定のヒープにのみレンダリングできるデバイスに、正しいヒープから割り当てられたオフスクリーンサーフェスがあることを確認できます。ヒープに対してこのフラグが設定されている場合、サーフェスはそのヒープから割り当てられません。
DDSCAPS_ALLOCONLOAD	サーフェスのメモリは、 IDirect3DTexture::Load メソッドを使用してアプリケーションによって読み込まれるまで割り当てられません。
DDSCAPS_ALPHA	このサーフェスにはアルファ情報のみが含まれます。
DDSCAPS_BACKBUFFER	このサーフェスは、サーフェス反転構造のバックバッファーです。通常、この機能は、DDSCAPS_FLIP フラグが使用されるときに、アプリケーションの CreateSurface メソッドによって設定されます。この機能が設定されているのは、DDSCAPS_FRONTBUFFERサーフェスの直前にあるサーフェスだけです。他のサーフェスは、DDSCAPS_FLIP フラグ、添付ファイルの順序、およびDDSCAPS_FRONTBUFFER機能とDDSCAPS_BACKBUFFER機能がないことによってバックバッファーとして識別されます。この機能がアプリケーションの CreateSurface メソッドに送信されると、スタンドアロンのバックバッファーが作成されます。このメソッドを呼び出した後、このサーフェスをフロントバッファー、別のバックバッファー、またはその両方にアタッチして反転サーフェス構造を形成できます。詳細については、DirectX SDK の AddAttachedSurface メソッドを参照してください。 DirectDraw では、反転構造で任意の数のサーフェスがサポートされます。
DDSCAPS_COMPLEX	複雑なサーフェスが記述されています。複雑なサーフェスでは、複数のサーフェスが作成されます。追加のサーフェスはルートサーフェスにアタッチされます。複雑な構造は、ルートを破棄することによってのみ破棄できます。
DDSCAPS_EXECUTEBUFFER	サーフェスは、Microsoft Direct3D 表示リストを保持するシステムまたはビデオメモリの線形チャンクである実行バッファーです。ドライバーは、ビデオメモリに実行バッファーを作成できることを示すために、この機能ビットを報告します。 Direct3D ランタイムがこのビットを検出すると、ドライバーから実行バッファーを要求できます。アプリケーションでは、この機能ビットを検出できません。
DDSCAPS_FLIP	このサーフェスは、サーフェス反転構造の一部です。この機能がアプリケーションの CreateSurface メソッドに渡されると、フロントバッファーと 1 つ以上のバックバッファーが作成されます。 DirectDraw は、フロントバッファーサーフェスのDDSCAPS_FRONTBUFFERビットと、フロントバッファーサーフェスに隣接するサーフェス上のDDSCAPS_BACKBUFFERビットを設定します。メソッド呼び出しを成功させるには、DDSURFACEDESC 構造体の dwBackBufferCount メンバーを少なくとも 1 に設定する必要があります。 CreateSurface メソッドを使用して複数のサーフェスを作成する場合は、常にDDSCAPS_COMPLEX機能を設定する必要があります。
DDSCAPS_FRONTBUFFER	このサーフェスは、サーフェス反転構造のフロントバッファーです。このフラグは、通常、DDSCAPS_FLIP機能が設定されている場合に、アプリケーションの CreateSurface メソッドによって設定されます。この機能が CreateSurface メソッドに送信されると、スタンドアロンのフロントバッファーが作成されます。このサーフェスには、DDSCAPS_FLIP機能がありません。アプリケーションの AddAttachedSurface メソッドを使用して、他のバックバッファーにアタッチして反転構造を形成できます。
DDSCAPS_HWCODEC	このサーフェスは、ハードウェアによってストリームを圧縮解除できる必要があります。
DDSCAPS_LIVEVIDEO	この画面は、ライブビデオを受信できる必要があります。
DDSCAPS_LOCALVIDMEM	このサーフェスは、ローカル以外の表示メモリではなく、true のローカル表示メモリに存在します。このフラグを指定する場合は、DDSCAPS_VIDEOMEMORYも指定する必要があります。このフラグは、DDSCAPS_NONLOCALVIDMEM フラグと共に使用できません。
DDSCAPS_MIPMAP	このサーフェスはミップマップの 1 レベルです。このサーフェスは、ミップマップを形成するために他のDDSCAPS_MIPMAPサーフェスにアタッチされます。これを明示的に行うには、複数のサーフェスを作成し、アプリケーションの AddAttachedSurface メソッドを使用してアタッチするか、アプリケーションの CreateSurface メソッドで暗黙的にアタッチします。この機能が設定されている場合は、DDSCAPS_TEXTUREも設定する必要があります。
DDSCAPS_MODEX	このサーフェスは、320 x 200 または 320 x 240 モード X サーフェスです。この機能ビットが Microsoft Windows 2000 以降のドライバーによって設定されている場合、DirectDraw は無効になります。
DDSCAPS_NONLOCALVIDMEM	このサーフェスは、true のローカル表示メモリではなく、ローカル以外の表示メモリに存在します。このフラグを指定する場合は、DDSCAPS_VIDEOMEMORYフラグも指定する必要があります。これは、DDSCAPS_LOCALVIDMEM フラグでは使用できません。
DDSCAPS_OFFSCREENPLAIN	このサーフェスは、オーバーレイ、テクスチャ、z バッファー、フロントバッファー、バックバッファー、アルファサーフェスではないオフスクリーンサーフェスです。プレーンサーフェスを識別するために使用されます。
DDSCAPS_OVERLAY	このサーフェスはオーバーレイです。このオーバーレイの可視性は、現在プライマリサーフェスにオーバーレイされているかどうかによって異なります。 DDSCAPS_VISIBLEを使用して、現時点でオーバーレイされているかどうかを判断できます。
DDSCAPS_OPTIMIZED	このフラグは現在実装されていません。
DDSCAPS_OWNDC	この画面には、長期間にわたってデバイスコンテキスト (DC) の関連付けが含まれます。この機能ビットが Windows 2000 以降のドライバーによって設定されている場合、DirectDraw は無効になります。
DDSCAPS_PALETTE	このデバイスドライバーを使用すると、一意の DirectDrawPalette オブジェクトを作成し、この画面にアタッチできます。
DDSCAPS_PRIMARYSURFACE	このサーフェスはプライマリサーフェスです。これは、現時点でユーザーに表示される内容を表します。
DDSCAPS_PRIMARYSURFACELEFT	このサーフェスは、左目のプライマリサーフェスです。これは、現時点でユーザーの左目に表示される内容を表します。このサーフェスを作成すると、DDSCAPS_PRIMARYSURFACE機能を持つサーフェスは、ユーザーの右目に表示される内容を表します。
DDSCAPS_STANDARDVGAMODE	このサーフェスは標準の VGA モードサーフェスであり、ModeX サーフェスではありません。このフラグは、DDSCAPS_MODEX フラグと組み合わせて使用することはできません。
DDSCAPS_SYSTEMMEMORY	このサーフェスメモリは、システムメモリから割り当てられています。この機能ビットが Windows 2000 以降のドライバーによって設定されている場合、DirectDraw は無効になります。
DDSCAPS_TEXTURE	このサーフェスは、3D テクスチャとして使用できます。サーフェスがその目的で使用されているかどうかは示されません。
DDSCAPS_VIDEOMEMORY	このサーフェスは、ディスプレイメモリに存在します。
DDSCAPS_VIDEOPORT	このサーフェスは、ビデオポート拡張機能 (VPE) オブジェクトからデータを受信できます。
DDSCAPS_VISIBLE	このサーフェスに加えられた変更がすぐに表示されます。これは常にプライマリサーフェスに対して設定され、オーバーレイの場合はオーバーレイに設定され、テクスチャが設定されている間はテクスチャマップに設定されます。
DDSCAPS_WRITEONLY	サーフェスへの書き込みアクセスのみが許可されます。サーフェスからの読み取りアクセスによって一般的な保護エラー (GPF) が発生する可能性がありますが、このサーフェスからの読み取り結果は意味がありません。この機能ビットが Windows 2000 以降のドライバーによって設定されている場合、DirectDraw は無効になります。
DDSCAPS_ZBUFFER	このサーフェスは z バッファーです。表示されるピクセルと隠れているピクセルを決定するために使用されるビット深度情報が含まれています。 z バッファーには、表示できない情報が含まれています。

注釈

この構造体は、ドライバーがサポートするサーフェスの種類を報告するためにドライバーによって使用されます。また、作成するサーフェスの種類を指定するために、アプリケーションによって入力されます。

要件

要件	値
Header	ddraw.h

次の方法で共有

DDSCAPS 構造体 (ddraw.h)

構文

メンバー

注釈

要件

フィードバック

その他のリソース