DDCORECAPS 構造体 (ddrawi.h)

DDCORECAPS 構造体は、DirectDraw オブジェクトを介してアプリケーションに公開される Microsoft DirectDraw ドライバーとそのデバイスのコア機能を指定します。

構文

typedef struct _DDCORECAPS {
  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   dwMaxVideoPorts;
  DWORD   dwCurrVideoPorts;
  DWORD   dwSVBCaps2;
} DDCORECAPS;

メンバー

dwSize

この DDCORECAPS 構造体のサイズをバイト単位で指定します。

dwCaps

ドライバーの機能を指定するフラグを示します。 ドライバーは、サポートされているすべての機能に適切なDDCAPS_Xxx ビットを設定する必要があります。

dwCaps2

ドライバーの機能をさらに指定します。 ドライバーは、サポートされているすべての機能に適切なDDCAPS2_Xxx ビットを設定する必要があります。

dwCKeyCaps

サーフェスのカラー キー機能を指定します。 ドライバーは、サポートされているすべての機能に適切なDDCKEYCAPS_Xxx ビットを設定する必要があります。

dwFXCaps

ドライバーのストレッチ機能と効果機能を指定します。 ドライバーは、サポートされているすべての機能に適切なDDFXCAPS_Xxx ビットを設定する必要があります。

dwFXAlphaCaps

このメンバーとそのフラグは古く、ドライバーで使用しないでください。

dwPalCaps

ドライバーのパレット機能を指定します。 ドライバーは、サポートされているすべての機能に適切なDDPCAPS_Xxx ビットを設定する必要があります。 DDPCAPS_Xxx フラグは ddraw.h で定義されます。 現在、DirectDraw ランタイムはこれらの機能を無視しています。

dwSVCaps

ドライバーのステレオ ビジョン機能を指定します。 ドライバーは、サポートされているすべての機能に適切なDDSVCAPS_Xxx ビットを設定する必要があります。

dwAlphaBltConstBitDepths

システムで使用するために予約されています。 ドライバーは、このメンバーを無視する必要があります。

dwAlphaBltPixelBitDepths

システムで使用するために予約されています。 ドライバーは、このメンバーを無視する必要があります。

dwAlphaBltSurfaceBitDepths

システムで使用するために予約されています。 ドライバーは、このメンバーを無視する必要があります。

dwAlphaOverlayConstBitDepths

システムで使用するために予約されています。 ドライバーは、このメンバーを無視する必要があります。

dwAlphaOverlayPixelBitDepths

システムで使用するために予約されています。 ドライバーは、このメンバーを無視する必要があります。

dwAlphaOverlaySurfaceBitDepths

システムで使用するために予約されています。 ドライバーは、このメンバーを無視する必要があります。

dwZBufferBitDepths

ドライバーでサポートされている Z バッファーの深さを指定するフラグを示します。 これは、次の値のなかから 1 つまたは複数を指定できます。

dwVidMemTotal

表示メモリの合計量をバイト単位で指定します。

dwVidMemFree

空き表示メモリのバイト数を指定します。 ドライバーは、初期化中にこのメンバーを dwVidMemTotal メンバーで返されるのと同じ値に 1 回設定します。 DirectDraw は、アプリケーションがメモリ割り当てを行うたびに更新します。

dwMaxVisibleOverlays

表示されるオーバーレイの最大数を指定します。

dwCurrVisibleOverlays

表示されているオーバーレイの現在の数を指定します。

dwNumFourCCCodes

ドライバーがサポートする FOURCC コードの数を指定します。

dwAlignBoundarySrc

ソースの四角形の配置を指定します。 このメンバーは、必要に応じてドライバーによって設定できます。 ドライバーがこのメンバーを設定する場合、オーバーレイソースの四角形の左上の座標値は dwAlignBoundarySrc の倍数である必要があります。

dwAlignSizeSrc

ソース四角形のサイズをバイト単位で指定します。 このメンバーは、必要に応じてドライバーによって設定できます。 ドライバーがこのメンバーを設定する場合、オーバーレイソースの四角形の幅は dwAlignSizeSrc の倍数である必要があります。

dwAlignBoundaryDest

移動先の四角形の配置を指定します。 このメンバーは、必要に応じてドライバーによって設定できます。 ドライバーがこのメンバーを設定する場合、オーバーレイ先の四角形の左上の座標値は dwAlignBoundaryDest の倍数である必要があります。

dwAlignSizeDest

コピー先の四角形のバイト サイズを指定します。 このメンバーは、必要に応じてドライバーによって設定できます。 ドライバーがこのメンバーを設定する場合、オーバーレイ先の四角形の幅は dwAlignSizeDest の倍数である必要があります。

dwAlignStrideAlign

システムで使用するために予約されており、ドライバーでは無視する必要があります。

dwRops[DD_ROP_SPACE]

ドライバーがサポートする IRP を示すフラグを一緒に保持できるDD_ROP_SPACE DWORD の配列を指定します。 ドライバーは、サポートされているすべての対応する ROP のビットフィールドを設定する必要があります。 ROP の詳細については、Microsoft Windows SDKドキュメントを参照してください。

ddsCaps

ドライバーがサポートするサーフェスの種類を記述する DDSCAPS 構造体を指定します。

dwMinOverlayStretch

オーバーレイの最小ストレッチ係数に 1000 を乗算して指定します。 たとえば、1.3 の係数は 1300 として格納する必要があります。 ディスプレイ ドライバーは、グラフィックス ハードウェアがオーバーレイを縮小できる実際の最小値に最小係数を設定する必要があります。 グラフィックス ハードウェアに最小制限がない場合は、1 に設定します。

dwMaxOverlayStretch

オーバーレイの最大ストレッチ係数に 1000 を掛けた値を指定します。 たとえば、1.3 の係数は 1300 として格納する必要があります。 ディスプレイ ドライバーは、グラフィックス ハードウェアがオーバーレイを拡張できる実際の最大値に最大係数を設定する必要があります。 グラフィックス ハードウェアに最大制限がない場合は、32000 に設定します。

dwMinLiveVideoStretch

ライブ ビデオの最小ストレッチ係数に 1000 を掛けた値を指定します。 たとえば、1.3 の係数は 1300 として格納する必要があります。

dwMaxLiveVideoStretch

最大ライブ ビデオストレッチ係数に 1000 を掛けた値を指定します。 たとえば、1.3 の係数は 1300 として格納する必要があります。

dwMinHwCodecStretch

ハードウェア コーデックの最小ストレッチ係数に 1000 を掛けた値を指定します。 たとえば、1.3 の係数は 1300 として格納する必要があります。

dwMaxHwCodecStretch

ハードウェア コーデックの最大ストレッチ係数に 1000 を掛けた値を指定します。 たとえば、1.3 の係数は 1300 として格納する必要があります。

dwReserved1

システムで使用するために予約されています。 ドライバーは、このメンバーを無視する必要があります。

dwReserved2

システムで使用するために予約されています。 ドライバーは、このメンバーを無視する必要があります。

dwReserved3

システムで使用するために予約されています。 ドライバーは、このメンバーを無視する必要があります。

dwSVBCaps

system-memory-to-display-memory blits のドライバー固有の機能を指定するフラグのセットを示します。 ドライバーは、メモリを表示するためにシステム メモリから blitting するときにサポートされる blit 操作の種類を示すために、適切なDDCAPS_Xxx フラグ ( dwCaps メンバーを参照) をビット単位で実行する必要があります。

dwSVBCKeyCaps

system-memory-to-display-memory blits のドライバーのカラー キー機能を指定するフラグのセットを示します。 ドライバーは、システム メモリからメモリを表示するために blitting するときにサポートされるカラー キー操作の種類を示すために、適切な DDCKEYCAPS_Xxx フラグ ( dwCKeyCaps メンバーを参照) をビット単位で実行する必要があります。

dwSVBFXCaps

system-memory-to-display-memory blits のドライバー FX 機能を指定するフラグのセットを示します。 ドライバーは、メモリを表示するためにシステム メモリから blitting するときにサポートされる効果の種類を示すために、適切なDDFXCAPS_Xxx フラグ ( dwFXCaps メンバーを参照) をビット単位で実行する必要があります。

dwSVBRops[DD_ROP_SPACE]

system-memory-to-display-memory blits を実行するときにドライバーがサポートする ROM を示すフラグを一緒に保持できる、DD_ROP_SPACE DWORD の配列を指定します。 ドライバーは、サポートされているすべての対応する ROP のビットフィールドを設定する必要があります。 ROP の詳細については、Microsoft Windows SDKドキュメントを参照してください。

dwVSBCaps

ディスプレイ メモリからシステム メモリ blits のドライバー固有の機能を指定するフラグのセットを示します。 ドライバーは、ディスプレイ メモリからシステム メモリに blitting するときにサポートされる blit 操作の種類を示すために、適切なDDCAPS_Xxx フラグ ( dwCaps メンバーを参照) をビット単位で実行する必要があります。

dwVSBCKeyCaps

display-memory-to-system-memory blits のドライバーのカラー キー機能を指定するフラグのセットを示します。 ドライバーは、ディスプレイ メモリからシステム メモリに blitting するときにサポートされるカラー キー操作の種類を示すために、適切な DDCKEYCAPS_Xxx フラグ ( dwCKeyCaps メンバーを参照) をビット単位で実行する必要があります。

dwVSBFXCaps

display-memory-to-system-memory blits のドライバー FX 機能を指定するフラグのセットを示します。 ドライバーは、ディスプレイ メモリからシステム メモリに blitting するときにサポートされる効果の種類を示すために、適切なDDFXCAPS_Xxx フラグ ( dwFXCaps メンバーを参照) をビット単位またはビット処理する必要があります。

dwVSBRops[DD_ROP_SPACE]

表示メモリからシステムメモリへの blit を実行するときにドライバーがサポートする ROM を示すフラグを一緒に保持できる、DD_ROP_SPACE DWORD の配列を指定します。 ドライバーは、サポートされているすべての対応する ROP のビットフィールドを設定する必要があります。 ROP の詳細については、Windows SDK のドキュメントを参照してください。

dwSSBCaps

system-memory-to-system-memory blits のドライバー固有の機能を指定するフラグのセットを示します。 ドライバーは、システム メモリからシステム メモリに blitting するときにサポートされる blit 操作の種類を示すために、適切な DDCAPS_Xxx フラグ ( dwCaps メンバーを参照してください) をビット単位で実行する必要があります。

dwSSBCKeyCaps

system-memory-to-system-memory blits のドライバーのカラー キー機能を指定するフラグのセットを示します。 ドライバーは、システム メモリからシステム メモリに blitting するときにサポートされるカラー キー操作の種類を示すために、ビット単位または適切なDDCKEYCAPS_Xxx フラグ ( dwCKeyCaps メンバーを参照) を使用する必要があります。

dwSSBFXCaps

system-memory-to-system-memory blits のドライバー FX 機能を指定するフラグのセットを示します。 ドライバーは、システム メモリからシステム メモリに blitting するときにサポートされる効果の種類を示すために、適切なDDFXCAPS_Xxx フラグ ( dwFXCaps メンバーを参照) をビット単位で実行する必要があります。

dwSSBRops[DD_ROP_SPACE]

DD_ROP_SPACE DWORD の配列を指定します。この配列は、システム メモリ間の blit を実行するときにドライバーがサポートする ROM を示すフラグを一緒に保持できます。 ドライバーは、サポートされているすべての対応する ROP のビットフィールドを設定する必要があります。 ROP の詳細については、Windows SDK のドキュメントを参照してください。

dwMaxVideoPorts

使用可能な VPE オブジェクトの最大数を指定します。

dwCurrVideoPorts

使用されている VPE オブジェクトの現在の数を指定します。 ドライバーは DirectDraw によって設定されているため、このメンバーを入力する必要はありません。

dwSVBCaps2

system-memory-to-display-memory blits のドライバー固有の追加機能を指定します。 有効なフラグは、 dwCaps2 メンバーで使用される blit 関連のフラグと同じです。

注釈

このセクションには、Windows 98/Me で使用されるフォームである DDCORECAPS という形式の DirectDraw ドライバー構造体が含まれます。 この構造体は、WINDOWS 2000 以降のバージョンで使用されるフォームである DDNTCORECAPS という形式の名前を持つ構造体と同じです。 インクルード ファイル dx95type.h には、DDNTCORECAPS から DDCORECAPS に定義された型が含まれています。

この構造体は、DDCAPS 構造体の最初のエントリを反映しますが、固定サイズであり、DDCAPS と同じように拡張されません。

ドライバーは、DrvGetDirectDrawInfo 構造体のDD_HALINFO構造体の他のメンバーを初期化するときに DDCORECAPS を初期化します。 DirectDraw ランタイムは、一部のメンバーを更新する場合があります。

DirectDraw は、DD_HALINFO構造体でも返される DdGetDriverInfo 関数を呼び出すことによって、追加のドライバー機能を要求します。

要件