DDCAPS_DX3 構造体 (ddraw.h)

DDCAPS 構造体は、DirectDraw オブジェクトを介して公開されるハードウェアの機能を表します。 この構造体には、このコンテキストで作成できる DirectDrawSurface オブジェクトの種類を記述するために使用される DDSCAPS2 構造体が含まれています。 これらの機能によって記述されたすべてのサーフェスを同時に作成できない場合があります。 この構造体は、 IDirectDraw7::GetCaps メソッドと共に使用されます。

Ddraw.h ヘッダー ファイルには、この構造体の複数のバージョン (たとえば、DDCAPS_DX7) が含まれています。 使用するバージョンを決定する方法の詳細については、「解説」を参照してください。

構文

typedef struct _DDCAPS_DX3 {
  DWORD   dwSize;
  DWORD   dwCaps;
  DWORD   dwCaps2;
  DWORD   dwCKeyCaps;
  DWORD   dwFXCaps;
  DWORD   dwFXAlphaCaps;
  DWORD   dwPalCaps;
  DWORD   dwSVCaps;
  DWORD   dwAlphaBltConstBitDepths;
  DWORD   dwAlphaBltPixelBitDepths;
  DWORD   dwAlphaBltSurfaceBitDepths;
  DWORD   dwAlphaOverlayConstBitDepths;
  DWORD   dwAlphaOverlayPixelBitDepths;
  DWORD   dwAlphaOverlaySurfaceBitDepths;
  DWORD   dwZBufferBitDepths;
  DWORD   dwVidMemTotal;
  DWORD   dwVidMemFree;
  DWORD   dwMaxVisibleOverlays;
  DWORD   dwCurrVisibleOverlays;
  DWORD   dwNumFourCCCodes;
  DWORD   dwAlignBoundarySrc;
  DWORD   dwAlignSizeSrc;
  DWORD   dwAlignBoundaryDest;
  DWORD   dwAlignSizeDest;
  DWORD   dwAlignStrideAlign;
  DWORD   dwRops[DD_ROP_SPACE];
  DDSCAPS ddsCaps;
  DWORD   dwMinOverlayStretch;
  DWORD   dwMaxOverlayStretch;
  DWORD   dwMinLiveVideoStretch;
  DWORD   dwMaxLiveVideoStretch;
  DWORD   dwMinHwCodecStretch;
  DWORD   dwMaxHwCodecStretch;
  DWORD   dwReserved1;
  DWORD   dwReserved2;
  DWORD   dwReserved3;
  DWORD   dwSVBCaps;
  DWORD   dwSVBCKeyCaps;
  DWORD   dwSVBFXCaps;
  DWORD   dwSVBRops[DD_ROP_SPACE];
  DWORD   dwVSBCaps;
  DWORD   dwVSBCKeyCaps;
  DWORD   dwVSBFXCaps;
  DWORD   dwVSBRops[DD_ROP_SPACE];
  DWORD   dwSSBCaps;
  DWORD   dwSSBCKeyCaps;
  DWORD   dwSSBFXCaps;
  DWORD   dwSSBRops[DD_ROP_SPACE];
  DWORD   dwReserved4;
  DWORD   dwReserved5;
  DWORD   dwReserved6;
} DDCAPS_DX3;

メンバー

dwSize

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

dwCaps

この値は、ハードウェアとドライバーの機能を指定する次のフラグの 1 つ以上で構成されます。

DDCAPS_3D

ディスプレイ ハードウェアには、3-D アクセラレーションがあります。

DDCAPS_ALIGNBOUNDARYDEST

DirectDraw では、x 軸がサーフェスの dwAlignBoundaryDest 境界に揃えられたオーバーレイ先の四角形のみがサポートされます。

DDCAPS_ALIGNBOUNDARYSRC

DirectDraw では、x 軸がサーフェスの dwAlignBoundarySrc 境界に揃えられたオーバーレイ ソース四角形のみがサポートされます。

DDCAPS_ALIGNSIZEDEST

DirectDraw では、x 軸のサイズ (ピクセル単位) が dwAlignSizeDest 倍数であるオーバーレイ先の四角形のみがサポートされます。

DDCAPS_ALIGNSIZESRC

DirectDraw では、x 軸のサイズ (ピクセル単位) が dwAlignSizeSrc 倍数であるオーバーレイ ソース四角形のみがサポートされます。

DDCAPS_ALIGNSTRIDE

DirectDraw は、 dwAlignStrideAlign 値と等しいストライドアラインメントを持つ表示メモリ サーフェスを作成します。

DDCAPS_ALPHA

ディスプレイ ハードウェアでは、アルファのみのサーフェスがサポートされています。

DDCAPS_BANKSWITCHED

ディスプレイ ハードウェアはバンクスイッチされ、ディスプレイ メモリへのランダム アクセスで非常に遅くなる可能性があります。

DDCAPS_BLT

ディスプレイ ハードウェアは、ビット ブロック転送 (ビットblt) 操作が可能です。

DDCAPS_BLTCOLORFILL

ディスプレイハードウェアは、blitterで色を塗りつぶすことができます。

DDCAPS_BLTDEPTHFILL

ディスプレイ ハードウェアは、z バッファーを blitter で埋める深度が可能です。

DDCAPS_BLTFOURCC

ディスプレイ ハードウェアは、ビットblt 操作中に色空間変換が可能です。

DDCAPS_BLTQUEUE

ディスプレイ ハードウェアは、非同期ビットblt 操作が可能です。

DDCAPS_BLTSTRETCH

ディスプレイ ハードウェアは、ビットblt 操作中にストレッチが可能です。

DDCAPS_CANBLTSYSMEM

ディスプレイ ハードウェアは、システム メモリに対して、またはシステム メモリから blitting できます。

DDCAPS_CANCLIP

ディスプレイ ハードウェアは、blitting を使用してクリッピングできます。

DDCAPS_CANCLIPSTRETCHED

ディスプレイ ハードウェアは、ストレッチ ブリッティング中にクリッピングが可能です。

DDCAPS_COLORKEY

オーバーレイ操作またはビットブレット操作で、何らかの形式のカラー キーをサポートします。 より具体的なカラー キー機能の情報については、 dwCKeyCaps メンバーを参照してください。

DDCAPS_COLORKEYHWASSIST

カラー キーは、部分的にハードウェア支援されます。 つまり、他のリソース (CPU またはビデオ メモリ) が使用される可能性があります。 このビットが設定されていない場合は、ハードウェアの完全なサポートが行われます。

DDCAPS_GDI

ディスプレイ ハードウェアは GDI と共有されます。

DDCAPS_NOHARDWARE

ハードウェアのサポートはありません。

DDCAPS_OVERLAY

ディスプレイ ハードウェアではオーバーレイがサポートされています。

DDCAPS_OVERLAYCANTCLIP

ディスプレイ ハードウェアはオーバーレイをサポートしていますが、クリップすることはできません。

DDCAPS_OVERLAYFOURCC

オーバーレイ ハードウェアは、オーバーレイ操作中に色空間変換が可能です。

DDCAPS_OVERLAYSTRETCH

オーバーレイ ハードウェアは、ストレッチが可能です。 dwMinOverlayStretch メンバーと dwMaxOverlayStretch メンバーには、有効なデータが含まれています。

DDCAPS_PALETTE

DirectDraw は、プライマリ サーフェス以外のサーフェスに対して DirectDrawPalette オブジェクトを作成およびサポートできます。

DDCAPS_PALETTEVSYNC

DirectDraw は、垂直更新と同期されたパレットを更新できます。

DDCAPS_READSCANLINE

ディスプレイ ハードウェアは、現在のスキャン行を返すことができます。

DDCAPS_VBI

ディスプレイ ハードウェアは、垂直ブランク割り込みを生成できます。

DDCAPS_ZBLTS

ビットblt 操作での z バッファーの使用をサポートします。

DDCAPS_ZOVERLAYS

オーバーレイがレイヤーを制御するための z 値として IDirectDrawSurface7::UpdateOverlayZOrder メソッドの使用をサポートします。

dwCaps2

この値は、より多くのハードウェアとドライバーの機能を指定する次のフラグの 1 つ以上で構成されます。

DDCAPS2_AUTOFLIPOVERLAY

オーバーレイは、ビデオ ポート VSYNC が発生するたびに反転チェーン内の次のサーフェスに自動的に反転できるため、ビデオ ポートとオーバーレイで CPU オーバーヘッドなしでビデオをダブルバッファーできます。 このオプションは、サーフェスがビデオ ポートからデータを受信している場合にのみ有効です。 ビデオ ポート データがインターレースされていないか、またはインターレーブされていない場合は、すべての VSYNC で反転します。 データがメモリ内でインターリーブされている場合は、他のすべての VSYNC で反転します。

DDCAPS2_CANBOBHARDWARE

オーバーレイ ハードウェアは、インターレースされたビデオ ストリームの各フィールドを個別に表示できます。

DDCAPS2_CANBOBINTERLEAVED

オーバーレイ ハードウェアは、インターレースされたビデオ ストリームの各フィールドを個別に表示できますが、メモリ内でインターリーブされている間は、通常、特別なハードウェアサポートなしで発生する可能性のある成果物を発生させずに表示できます。 このオプションは、サーフェスがビデオ ポートからデータを受信していて、ビデオが垂直方向に少なくとも 2 回ズームされている場合にのみ有効です。

DDCAPS2_CANBOBNONINTERLEAVED

オーバーレイ ハードウェアは、インターレースされたビデオ ストリームの各フィールドを個別に表示できますが、メモリ内ではインターリーブされず、通常は特別なハードウェアサポートなしで発生する可能性があります。 このオプションは、サーフェスがビデオ ポートからデータを受信していて、ビデオが垂直方向に少なくとも 2 回ズームされている場合にのみ有効です。

DDCAPS2_CANCALIBRATEGAMMA

システムには、ガンマランプを自動的に調整できる校正器がインストールされているため、校正器を持つすべてのシステムで結果が同じになります。 新しいガンマ レベルを設定するときに校正器を呼び出すには、 IDirectDrawGammaControl::SetGammaRamp メソッドを呼び出すときにDDSGR_CALIBRATE フラグを使用します。 ガンマ ランプを調整すると、処理オーバーヘッドが発生し、頻繁に使用しないでください。

DDCAPS2_CANDROPZ16BIT

16 ビット RGBZ 値は、16 ビットの RGB 値に変換できます。 (システムは 8 ビット変換をサポートしていません)。

DDCAPS2_CANFLIPODDEVEN

ドライバーは、 IDirectDrawSurface7::Flip メソッドで使用されるDDFLIP_ODDフラグとDDFLIP_EVEN フラグで指定されているように、奇数と偶数の反転操作を実行できます。

DDCAPS2_CANMANAGETEXTURE

Direct3D テクスチャ マネージャーは、この機能を使用して、マネージド サーフェスを非ローカル ビデオ メモリに配置するかどうかを決定します。 機能が設定されている場合、テクスチャ マネージャーは、ローカル以外のビデオ メモリにマネージド サーフェスを配置します。 ローカル ビデオ メモリからテクスチャを設定できないドライバーでは、この機能を設定しないでください。

DDCAPS2_CANRENDERWINDOWED

ドライバーは、ウィンドウ モードでレンダリングできます。

DDCAPS2_CERTIFIED

ディスプレイ ハードウェアが認定されています。

DDCAPS2_COLORCONTROLPRIMARY

プライマリ サーフェスにはカラー コントロール (ガンマなど) が含まれています。

DDCAPS2_COLORCONTROLOVERLAY

オーバーレイ サーフェスには、カラー コントロール (明るさやシャープネスなど) が含まれています。

DDCAPS2_COPYFOURCC

ドライバーは、同じ FOURCC の別のサーフェスへの FOURCC サーフェスの blitting をサポートしています。

DDCAPS2_FLIPINTERVAL

ドライバーは、DDFLIP_INTERVAL* フラグに応答します。 (これらのフラグの詳細については、「 IDirectDrawSurface7::Flip」を参照してください)。

DDCAPS2_FLIPNOVSYNC

ドライバーは、DDFLIP_NOVSYNC フラグに応答します (このフラグの詳細については、「 IDirectDrawSurface7::Flip」を参照してください)。

DDCAPS2_NO2DDURING3DSCENE

IDirectDrawSurface7::Blt や IDirectDrawSurface7::Lock などの 2 次元操作は、BeginScene メソッドと EndScene メソッドの呼び出しの間に Direct3D が使用しているサーフェスでは実行できません。

DDCAPS2_NONLOCALVIDMEM

ディスプレイ ドライバーは、非ローカル ビデオ メモリ内のサーフェスをサポートします。

DDCAPS2_NONLOCALVIDMEMCAPS

ローカル以外のビデオ メモリ サーフェスのビットblt 機能は、ローカル のビデオ メモリ サーフェスとは異なります。 このフラグが存在する場合は、DDCAPS2_NONLOCALVIDMEM フラグも存在します。

DDCAPS2_NOPAGELOCKREQUIRED

DMA ビットブレット操作は、ページ ロックされていないシステム メモリ サーフェスでサポートされます。

DDCAPS2_PRIMARYGAMMA

プライマリ サーフェスのダイナミック ガンマ ランプをサポートします。

DDCAPS2_STEREO

DirectX 7.0 の新機能。 dwSVCaps ビットをオンにして、ステレオ モードをサポートします。 ドライバーは、現在のモード以外の少なくとも 1 つのモードでステレオを実行できます。 アプリケーションでは 、IDirectDraw7::GetDisplayMode または IDirectDraw7::EnumDisplayModes を使用して、モードごとのステレオ情報を取得できます。

DDCAPS2_TEXMANINNONLOCALVIDMEM

DirectX 7.0 の新機能。 Direct3D テクスチャ マネージャーは、この機能を使用して、マネージド サーフェスを非ローカル ビデオ メモリに配置するかどうかを決定します。 機能が設定されている場合、テクスチャ マネージャーは、ローカル以外のビデオ メモリにマネージド サーフェスを配置します。 ローカル ビデオ メモリからテクスチャを設定できないドライバーでは、この機能を設定しないでください。

DDCAPS2_VIDEOPORT

ディスプレイ ハードウェアはライブ ビデオをサポートしています。

DDCAPS2_WIDESURFACES

表示サーフェスは、プライマリ サーフェスよりも広いサーフェスをサポートします。

dwCKeyCaps

この値は、カラー キー機能を指定する次のフラグの 1 つ以上で構成されます。

DDCKEYCAPS_DESTBLT

RGB カラーの変換先サーフェスの置換可能なビットを識別するカラー キーを使用した透明な blitting をサポートします。

DDCKEYCAPS_DESTBLTCLRSPACE

RGB 色の変換先サーフェスの置換可能なビットを識別する色空間を持つ透明な blitting をサポートします。

DDCKEYCAPS_DESTBLTCLRSPACEYUV

YUV カラーの宛先サーフェスの置換可能なビットを識別する色空間を持つ透明な blitting をサポートします。

DDCKEYCAPS_DESTBLTYUV

YUV カラーの変換先サーフェスの置換可能なビットを識別するカラー キーを使用して透明な blitting をサポートします。

DDCKEYCAPS_DESTOVERLAY

RGB カラー用にオーバーレイする変換先サーフェスの置換可能ビットのカラー キーによるオーバーレイをサポートします。

DDCKEYCAPS_DESTOVERLAYCLRSPACE

RGB 色の変換先のカラー キーとして色空間をサポートします。

DDCKEYCAPS_DESTOVERLAYCLRSPACEYUV

YUV 色の変換先のカラー キーとして色空間をサポートします。

DDCKEYCAPS_DESTOVERLAYONEACTIVE

表示されているオーバーレイ サーフェスに対してアクティブな宛先カラー キー値を 1 つだけサポートします。

DDCKEYCAPS_DESTOVERLAYYUV

YUV カラー用にオーバーレイする宛先サーフェスの置換可能なビットのカラー キーを使用して、オーバーレイをサポートします。

DDCKEYCAPS_NOCOSTOVERLAY

カラー キーとオーバーレイを使用するための帯域幅のトレードオフがないことを示します。

DDCKEYCAPS_SRCBLT

RGB カラーの場合は、このサーフェスでソースのカラー キーを使用して、透明な blitting をサポートします。

DDCKEYCAPS_SRCBLTCLRSPACE

RGB カラーの場合は、このサーフェスでソースの色空間を使用して、透明な blitting をサポートします。

DDCKEYCAPS_SRCBLTCLRSPACEYUV

YUV カラーの場合は、このサーフェスを含むソースの色空間を使用して、透明な塗りつぶしをサポートします。

DDCKEYCAPS_SRCBLTYUV

YUV カラーの場合は、このサーフェスでソースのカラー キーを使用して、透明な blitting をサポートします。

DDCKEYCAPS_SRCOVERLAY

ソースのカラー キーを使用したオーバーレイをサポートし、RGB カラーの場合は、このオーバーレイ サーフェスを使用します。

DDCKEYCAPS_SRCOVERLAYCLRSPACE

RGB 色のオーバーレイ サーフェイスのソース カラー キーとして色空間を使用して、オーバーレイをサポートします。

DDCKEYCAPS_SRCOVERLAYCLRSPACEYUV

YUV カラーのオーバーレイ サーフェスのソース カラー キーとして色空間を使用して、オーバーレイをサポートします。

DDCKEYCAPS_SRCOVERLAYONEACTIVE

表示されているオーバーレイ サーフェスに対してアクティブなソース カラー キー値を 1 つだけサポートします。

DDCKEYCAPS_SRCOVERLAYYUV

ソースのカラー キーを使用してオーバーレイをサポートし、YUV カラーの場合は、このオーバーレイ サーフェスを使用します。

dwFXCaps

この値は、ドライバーのストレッチ機能と効果機能を指定する次のフラグの 1 つ以上で構成されます。

DDFXCAPS_BLTALPHA

アルファ ブレンドビット演算をサポートします。

DDFXCAPS_BLTARITHSTRETCHY

ビット演算中にサーフェスを拡大および縮小するために、ピクセルを 2 倍にする手法ではなく算術演算を使用します。 y 軸 (垂直方向) に沿って発生します。

DDFXCAPS_BLTARITHSTRETCHYN

ビット演算中にサーフェスを拡大および縮小するために、ピクセルを 2 倍にする手法ではなく算術演算を使用します。 y 軸 (垂直方向) に沿って発生し、整数のストレッチ (×1、×2 など) でのみ機能します。

DDFXCAPS_BLTFILTER

ドライバーは、反ったビットの表面再構築フィルター処理を実行できます。

DDFXCAPS_BLTMIRRORLEFTRIGHT

bitblt 操作で左から右へのミラーリングをサポートします。

DDFXCAPS_BLTMIRRORUPDOWN

ビットブレット操作で上から下へのミラーリングをサポートします。

DDFXCAPS_BLTROTATION

ビット単位の操作で任意の回転をサポートします。

DDFXCAPS_BLTROTATION90

ビットブレット操作で 90 度回転をサポートします。

DDFXCAPS_BLTSHRINKX

x 軸 (水平方向) に沿ったサーフェスの任意の縮小をサポートします。 このフラグは、bitblt 操作に対してのみ有効です。

DDFXCAPS_BLTSHRINKXN

x 軸 (水平方向) に沿ったサーフェスの整数の縮小 (×1、×2 など) をサポートします。 このフラグは、bitblt 操作に対してのみ有効です。

DDFXCAPS_BLTSHRINKY

y 軸 (垂直方向) に沿ったサーフェスの任意の縮小をサポートします。 このフラグは、bitblt 操作に対してのみ有効です。

DDFXCAPS_BLTSHRINKYN

y 軸 (垂直方向) に沿ったサーフェスの整数の縮小 (×1、×2 など) をサポートします。 このフラグは、bitblt 操作に対してのみ有効です。

DDFXCAPS_BLTSTRETCHX

x 軸 (水平方向) に沿ったサーフェスの任意のストレッチをサポートします。 このフラグは、bitblt 操作に対してのみ有効です。

DDFXCAPS_BLTSTRETCHXN

x 軸 (水平方向) に沿ったサーフェスの整数のストレッチ (×1、×2 など) をサポートします。 このフラグは、bitblt 操作に対してのみ有効です。

DDFXCAPS_BLTSTRETCHY

y 軸 (垂直方向) に沿ったサーフェスの任意のストレッチをサポートします。 このフラグは、bitblt 操作に対してのみ有効です。

DDFXCAPS_BLTSTRETCHYN

y 軸 (垂直方向) に沿ったサーフェスの整数のストレッチ (×1、×2 など) をサポートします。 このフラグは、bitblt 操作に対してのみ有効です。

DDFXCAPS_BLTTRANSFORM

blitted スプライトの幾何学的変換 (または反り) をサポートします。 現在、明示的なビットブレット操作では変換はサポートされていません。

DDFXCAPS_OVERLAYALPHA

オーバーレイ サーフェスのアルファ ブレンドをサポートします。

DDFXCAPS_OVERLAYARITHSTRETCHY

オーバーレイ サーフェスを拡大および縮小するために、ピクセルを 2 倍にする手法ではなく算術演算を使用します。 y 軸 (垂直方向) に沿って発生します。

DDFXCAPS_OVERLAYARITHSTRETCHYN

オーバーレイ サーフェスを拡大および縮小するために、ピクセルを 2 倍にする手法ではなく算術演算を使用します。 y 軸 (垂直方向) に沿って発生し、整数のストレッチ (×1、×2 など) でのみ機能します。

DDFXCAPS_OVERLAYFILTER

反ったオーバーレイ スプライトのサーフェス再構築フィルター処理をサポートします。 明示的に表示されるオーバーレイ サーフェス ( IDirectDrawSurface7::UpdateOverlay の呼び出しで表示されるオーバーレイ サーフェス) では、フィルター処理は現在サポートされていません。

DDFXCAPS_OVERLAYMIRRORLEFTRIGHT

縦軸全体のオーバーレイのミラーリングをサポートします。

DDFXCAPS_OVERLAYMIRRORUPDOWN

横軸全体のオーバーレイのミラーリングをサポートします。

DDFXCAPS_OVERLAYSHRINKX

x 軸 (水平方向) に沿ったサーフェスの任意の縮小をサポートします。 このフラグは、DDSCAPS_OVERLAYサーフェスに対してのみ有効です。 このフラグは、サーフェスの機能のみを示します。圧縮が使用可能であることを示すものではありません。

DDFXCAPS_OVERLAYSHRINKXN

x 軸 (水平方向) に沿ったサーフェスの整数の縮小 (×1、×2 など) をサポートします。 このフラグは、DDSCAPS_OVERLAYサーフェスに対してのみ有効です。 このフラグは、サーフェスの機能のみを示します。圧縮が使用可能であることを示すものではありません。

DDFXCAPS_OVERLAYSHRINKY

y 軸 (垂直方向) に沿ったサーフェスの任意の縮小をサポートします。 このフラグは、DDSCAPS_OVERLAYサーフェスに対してのみ有効です。 このフラグは、サーフェスの機能のみを示します。圧縮が使用可能であることを示すものではありません。

DDFXCAPS_OVERLAYSHRINKYN

y 軸 (垂直方向) に沿ったサーフェスの整数の縮小 (×1、×2 など) をサポートします。 このフラグは、DDSCAPS_OVERLAYサーフェスに対してのみ有効です。 このフラグは、サーフェスの機能のみを示します。圧縮が使用可能であることを示すものではありません。

DDFXCAPS_OVERLAYSTRETCHX

x 軸 (水平方向) に沿ったサーフェスの任意のストレッチをサポートします。 このフラグは、DDSCAPS_OVERLAYサーフェスに対してのみ有効です。 このフラグは、サーフェスの機能のみを示します。ストレッチが使用可能であることを示すものではありません。

DDFXCAPS_OVERLAYSTRETCHXN

x 軸 (水平方向) に沿ったサーフェスの整数のストレッチ (×1、×2 など) をサポートします。 このフラグは、DDSCAPS_OVERLAYサーフェスに対してのみ有効です。 このフラグは、サーフェスの機能のみを示します。ストレッチが使用可能であることを示すものではありません。

DDFXCAPS_OVERLAYSTRETCHY

y 軸 (垂直方向) に沿ったサーフェスの任意のストレッチをサポートします。 このフラグは、DDSCAPS_OVERLAYサーフェスに対してのみ有効です。 このフラグは、サーフェスの機能のみを示します。ストレッチが使用可能であることを示すものではありません。

DDFXCAPS_OVERLAYSTRETCHYN

y 軸 (垂直方向) に沿ったサーフェスの整数のストレッチ (×1、×2 など) をサポートします。 このフラグは、DDSCAPS_OVERLAYサーフェスに対してのみ有効です。 このフラグは、サーフェスの機能のみを示します。ストレッチが使用可能であることを示すものではありません。

DDFXCAPS_OVERLAYTRANSFORM

オーバーレイ スプライトのジオメトリ変換 (または反り) をサポートします。 明示的に表示されるオーバーレイ サーフェス ( IDirectDrawSurface7::UpdateOverlay の呼び出しで表示される) では、変換は現在サポートされていません。

dwFXAlphaCaps

この値は、ドライバーのアルファ機能を指定する次のフラグの 1 つ以上で構成されます。

DDFXALPHACAPS_BLTALPHAEDGEBLEND

ソースカラーキーサーフェスのエッジを囲むアルファ ブレンドをサポートします。 bitblt 操作に使用されます。

DDFXALPHACAPS_BLTALPHAPIXELS

ピクセル形式のアルファ情報をサポートします。 ピクセル形式のアルファ情報のビット深度には、1、2、4、または 8 を指定できます。 アルファ値が大きくなると、アルファ値はより不透明になります。 アルファ情報の深さに関係なく、0 は常に完全に透明な値です。 bitblt 操作に使用されます。

DDFXALPHACAPS_BLTALPHAPIXELSNEG

ピクセル形式のアルファ情報をサポートします。 ピクセル形式のアルファ情報のビット深度には、1、2、4、または 8 を指定できます。 アルファ値が大きくなると、アルファ値はより透明になります。 アルファ情報の深さに関係なく、0 は常に完全に不透明な値です。 このフラグは、DDCAPS_ALPHAが設定されている場合にのみ使用できます。 bitblt 操作に使用されます。

DDFXALPHACAPS_BLTALPHASURFACES

アルファのみのサーフェスをサポートします。 アルファのみのサーフェスのビット深度には、1、2、4、または 8 を指定できます。 アルファ値が大きくなると、アルファ値はより不透明になります。 アルファ情報の深さに関係なく、0 は常に完全に透明な値です。 bitblt 操作に使用されます。

DDFXALPHACAPS_BLTALPHASURFACESNEG

アルファ値が大きくなるとアルファ チャネルの透明度が高くなることを示します。 アルファ チャネル データの深さは、1、2、4、または 8 のいずれかです。 アルファ情報の深さに関係なく、0 は常に完全に不透明な値です。 このフラグは、DDCAPS_ALPHAが設定されている場合にのみ設定できます。 bitblt 操作に使用されます。

DDFXALPHACAPS_OVERLAYALPHAEDGEBLEND

ソースカラーキーサーフェスのエッジを囲むアルファ ブレンドをサポートします。 オーバーレイに使用されます。

DDFXALPHACAPS_OVERLAYALPHAPIXELS

ピクセル形式のアルファ情報をサポートします。 ピクセル形式のアルファ情報のビット深度には、1、2、4、または 8 を指定できます。 アルファ値が大きくなると、アルファ値はより不透明になります。 アルファ情報の深さに関係なく、0 は常に完全に透明な値です。 オーバーレイに使用されます。

DDFXALPHACAPS_OVERLAYALPHAPIXELSNEG

ピクセル形式のアルファ情報をサポートします。 ピクセル形式のアルファ情報のビット深度には、1、2、4、または 8 を指定できます。 アルファ値が大きくなると、アルファ値はより透明になります。 アルファ情報の深さに関係なく、0 は常に完全に不透明な値です。 このフラグは、DDCAPS_ALPHAが設定されている場合にのみ使用できます。 オーバーレイに使用されます。

DDFXALPHACAPS_OVERLAYALPHASURFACES

アルファのみのサーフェスをサポートします。 アルファのみのサーフェスのビット深度には、1、2、4、または 8 を指定できます。 アルファ値が大きくなると、アルファ値はより不透明になります。 アルファ情報の深さに関係なく、0 は常に完全に透明な値です。 オーバーレイに使用されます。

DDFXALPHACAPS_OVERLAYALPHASURFACESNEG

アルファ値が大きくなるとアルファ チャネルの透明度が高くなることを示します。 アルファ チャネル データの深さは、1、2、4、または 8 のいずれかです。 アルファ情報の深さに関係なく、0 は常に完全に不透明な値です。 このフラグは、DDCAPS_ALPHAが設定されている場合にのみ使用できます。 オーバーレイに使用されます。

dwPalCaps

この値は、パレット機能を指定する次のフラグの 1 つ以上で構成されます。

DDPCAPS_1BIT

1 ビットカラー エントリ (2 色) を含むパレットをサポートします。

DDPCAPS_2BIT

2 ビット カラー エントリ (4 色) を含むパレットをサポートします。

DDPCAPS_4BIT

4 ビット カラー エントリ (16 色) を含むパレットをサポートします。

DDPCAPS_8BIT

8 ビット カラー エントリ (256 色) を含むパレットをサポートします。

DDPCAPS_8BITENTRIES

8 ビットカラーインデックスへのインデックスを指定します。 このフィールドは、DDPCAPS_1BIT、DDPCAPS_2BIT、またはDDPCAPS_4BIT機能と共に使用され、ターゲット サーフェスがピクセルあたり 8 ビット (bpp) の場合にのみ有効です。 各カラー エントリは 1 バイトの長さであり、宛先サーフェス上の 8-bpp パレットのインデックスです。

DDPCAPS_ALPHA

アルファ コンポーネントを含むパレットをサポートします。 アルファ対応パレットの場合、パレットに含まれる各 PALETTEENTRY 構造体の peFlags メンバーは、(peRed、peGreen、および peBlue メンバーのカラー データに加えて) 1 つの 8 ビットアルファ値として解釈されます。 このフラグを使用して作成されたパレットは、テクスチャ サーフェスにのみアタッチできます。

DDPCAPS_ALLOW256

256 個すべてのエントリを定義できるパレットをサポートします。

DDPCAPS_PRIMARYSURFACE

パレットはプライマリ サーフェスにアタッチされます。 パレットを変更すると、DDPCAPS_VSYNC機能が指定され、サポートされていない限り、すぐに表示されます。

DDPCAPS_PRIMARYSURFACELEFT

パレットは、左側のプライマリ サーフェスにアタッチされます。 パレットを変更すると、DDPCAPS_VSYNC機能が指定され、サポートされていない限り、すぐに表示されます。

DDPCAPS_VSYNC

パレットはモニターのリフレッシュ レートと同期的に変更できます。

dwSVCaps

この値は、ステレオビジョン機能を指定する次のフラグの 1 つ以上で構成されます。

DDSVCAPS_RESERVED1、DDSVCAPS_RESERVED2、DDSVCAPS_RESERVED3、DDSVCAPS_RESERVED4

予約済みフラグ。

DDSVCAPS_STEREOSEQUENTIAL

DirectX 7.0 の新機能。 ドライバーは、現在のモード以外の少なくとも 1 つのモードでステレオを実行できます。 アプリケーションでは 、IDirectDraw7::GetDisplayMode または IDirectDraw7::EnumDisplayModes を使用して、モードごとのステレオ情報を取得できます。

dwAlphaBltConstBitDepths

DDBD_2、DDBD_4、またはDDBD_8。 (ピクセルあたり 2、4、または 8 ビットを示します)。

dwAlphaBltPixelBitDepths

DDBD_1、DDBD_2、DDBD_4、またはDDBD_8。 (ピクセルあたり 1、2、4、または 8 ビットを示します)。

dwAlphaBltSurfaceBitDepths

DDBD_1、DDBD_2、DDBD_4、またはDDBD_8。 (ピクセルあたり 1、2、4、または 8 ビットを示します)。

dwAlphaOverlayConstBitDepths

DDBD_2、DDBD_4、またはDDBD_8。 (ピクセルあたり 2、4、または 8 ビットを示します)。

dwAlphaOverlayPixelBitDepths

DDBD_1、DDBD_2、DDBD_4、またはDDBD_8。 (ピクセルあたり 1、2、4、または 8 ビットを示します)。

dwAlphaOverlaySurfaceBitDepths

DDBD_1、DDBD_2、DDBD_4、またはDDBD_8。 (ピクセルあたり 1、2、4、または 8 ビットを示します)。

dwZBufferBitDepths

DDBD_8、DDBD_16、DDBD_24、またはDDBD_32。 (ピクセルあたり 8、16、24、または 32 ビットを示します)。このメンバーは、DirectX 6.0 以降では使用されなくなりました。 サポートされている深度バッファー形式に関する情報を取得するには、 IDirect3D7::EnumZBufferFormats を使用します。

dwVidMemTotal

デバイス上のディスプレイ メモリの合計量 (バイト単位) から、プライマリ サーフェス用に予約されているメモリと、ドライバーによって予約されたプライベート データ構造を差し引いた値。 (この値は、 IDirectDraw7::GetAvailableVidMem メソッドによって報告された合計ビデオ メモリと同じです)。

dwVidMemFree

ディスプレイ メモリを解放します。 この値は 、dwVidMemTotal の値から、サーフェスに対してアプリケーションによって現在割り当てられているメモリを差し引いた値と等しくなります。 特定の種類のサーフェス (テクスチャなど) で使用可能なメモリを報告する IDirectDraw7::GetAvailableVidMem メソッドとは異なり、この値は任意の種類のサーフェスで使用可能なメモリを反映します。

dwMaxVisibleOverlays

表示されるオーバーレイまたはオーバーレイ スプライトの最大数。

dwCurrVisibleOverlays

表示されているオーバーレイまたはオーバーレイ スプライトの現在の数。

dwNumFourCCCodes

4CC コードの数。

dwAlignBoundarySrc

オーバーレイ サーフェスのソース四角形の配置 (ピクセル単位)。

dwAlignSizeSrc

オーバーレイ サーフェスのソースと四角形のサイズの配置 (ピクセル単位)。 オーバーレイソースの四角形には、この値の倍数であるピクセル幅が必要です。

dwAlignBoundaryDest

オーバーレイ サーフェスの宛先四角形の配置 (ピクセル単位)。

dwAlignSizeDest

オーバーレイ サーフェスの宛先四角形のサイズの配置 (ピクセル単位)。 オーバーレイ先の四角形には、この値の倍数であるピクセル幅が必要です。

dwAlignStrideAlign

ストライドアラインメント。

dwRops[DD_ROP_SPACE]

ラスター操作がサポートされています。

ddsCaps

一般的なサーフェス機能を含む DDSCAPS2 構造体。

dwMinOverlayStretch

オーバーレイのストレッチ係数の最小値に 1000 を掛けた値。 たとえば、1.3 = 1300 です。

dwMaxOverlayStretch

オーバーレイの最大ストレッチ係数を 1000 で乗算します。 たとえば、1.3 = 1300 です。

dwMinLiveVideoStretch

時代遅れ;は使用しないでください。

dwMaxLiveVideoStretch

時代遅れ;は使用しないでください。

dwMinHwCodecStretch

時代遅れ;は使用しないでください。

dwMaxHwCodecStretch

時代遅れ;は使用しないでください。

dwReserved1

予約済み

dwReserved2

予約済み

dwReserved3

予約済み

dwSVBCaps

システム メモリからメモリを表示するためのビットレットのドライバー固有の機能。 有効なフラグは、 dwCaps メンバーで使用されるビットblt 関連のフラグと同じです。

dwSVBCKeyCaps

システム メモリからのビットがメモリを表示するためのドライバー のカラー キー機能。 有効なフラグは、 dwCKeyCaps メンバーで使用される bitblt 関連のフラグと同じです。

dwSVBFXCaps

システム メモリからメモリを表示するためのビットブレットのドライバー FX 機能。 有効なフラグは、 dwFXCaps メンバーで使用される bitblt 関連のフラグと同じです。

dwSVBRops[DD_ROP_SPACE]

システム メモリからのビットブレットがメモリを表示するためにサポートされるラスター操作。

dwVSBCaps

ディスプレイ メモリからシステム メモリへのビットブレットのドライバー固有の機能。 有効なフラグは、 dwCaps メンバーで使用されるビットblt 関連のフラグと同じです。

dwVSBCKeyCaps

ディスプレイ メモリからシステム メモリへのビットブレットのドライバー カラー キー機能。 有効なフラグは、 dwCKeyCaps メンバーで使用される bitblt 関連のフラグと同じです。

dwVSBFXCaps

ディスプレイ メモリからシステム メモリへのビットブレットのドライバー FX 機能。 有効なフラグは、 dwFXCaps メンバーで使用される bitblt 関連のフラグと同じです。

dwVSBRops[DD_ROP_SPACE]

表示メモリからシステム メモリへのビットブレットに対してサポートされるラスター操作。

dwSSBCaps

システム メモリからシステム メモリへのビットブレットのドライバー固有の機能。 有効なフラグは、 dwCaps メンバーで使用される bitblt 関連のフラグと同じです。

dwSSBCKeyCaps

システム メモリからシステム メモリへのビットブレットのドライバー カラー キー機能。 有効なフラグは、 dwCKeyCaps メンバーで使用されるビットblt 関連のフラグと同じです。

dwSSBFXCaps

システム メモリからシステム メモリへのビットブレットのドライバー FX 機能。 有効なフラグは、 dwFXCaps メンバーで使用される bitblt 関連のフラグと同じです。

dwSSBRops[DD_ROP_SPACE]

システム メモリからシステム メモリへのビットブレットでサポートされるラスター操作。

dwReserved4

予約済み

dwReserved5

予約済み

dwReserved6

予約済み

解説

下位互換性のために、Ddraw.h ヘッダー ファイルには DDCAPS 構造体の複数の定義が含まれています。 プリプロセッサを渡すバージョンは、DIRECTDRAW_VERSION定数の値によって決まります。

要件

Header	ddraw.h