IDirectDraw7 インターフェイス (ddraw.h)

アプリケーションでは 、IDirectDraw7 インターフェイスのメソッドを使用して DirectDraw オブジェクトを作成し、システム レベルの変数を操作します。 このセクションは、 IDirectDraw7 インターフェイスのメソッドへの参照です。

継承

IDirectDraw7 インターフェイスは、IUnknown インターフェイスから継承されます。 IDirectDraw7 には、次の種類のメンバーもあります。

メソッド

IDirectDraw7 インターフェイスには、これらのメソッドがあります。

IDirectDraw7::Compact このメソッドは、現在実装されていません。 (IDirectDraw7.Compact)
IDirectDraw7::CreateClipper DirectDrawClipper オブジェクトを作成します。
IDirectDraw7::CreatePalette この DirectDraw オブジェクトの DirectDrawPalette オブジェクトを作成します。
IDirectDraw7::CreateSurface この DirectDraw オブジェクトの DirectDrawSurface オブジェクトを作成します。
IDirectDraw7::D uplicateSurface DirectDrawSurface オブジェクトを複製します。
IDirectDraw7::EnumDisplayModes DirectDraw オブジェクトを介してハードウェアが公開し、指定されたサーフェスの説明と互換性のあるすべての表示モードを列挙します。
IDirectDraw7::EnumSurfaces 指定したサーフェスの説明を満たす、既存または使用可能なすべてのサーフェスを列挙します。
IDirectDraw7::EvaluateMode IDirectDraw7::StartModeTest の呼び出し後に、テストが提示する各モードに合格または失敗し、テストが完了するまでモードをステップ実行するために使用されます。
IDirectDraw7::FlipToGDISurface GDI がプライマリ サーフェスに書き込むサーフェスを作成します。
IDirectDraw7::GetAvailableVidMem 使用可能な表示メモリの合計量と、特定の種類のサーフェスに対して現在空いている表示メモリの量を取得します。
IDirectDraw7::GetCaps ハードウェアとハードウェア エミュレーション レイヤー (HEL) のデバイス ドライバーの機能を取得します。
IDirectDraw7::GetDeviceIdentifier デバイス ドライバーに関する情報を取得します。 この方法は、ドライバーまたはチップセットの動作が悪い場合の回避策を実装するために、特定のハードウェアのインストールを認識するために注意して使用できます。
IDirectDraw7::GetDisplayMode 現在の表示モードを取得します。
IDirectDraw7::GetFourCCCodes DirectDraw オブジェクトでサポートされている 4 文字コード (FOURCC) を取得します。 このメソッドは、サポートされているコードの数を取得することもできます。
IDirectDraw7::GetGDISurface GDI がプライマリ サーフェスとして扱っているサーフェス メモリを現在表す DirectDrawSurface オブジェクトを取得します。
IDirectDraw7::GetMonitorFrequency DirectDraw オブジェクトが制御するモニターの頻度を取得します。
IDirectDraw7::GetScanLine モニターに現在描画されているスキャンラインを取得します。
IDirectDraw7::GetSurfaceFromDC GDI デバイス コンテキスト ハンドルに基づいて、サーフェスの IDirectDrawSurface7 インターフェイスを取得します。
IDirectDraw7::GetVerticalBlankStatus 垂直空白の状態を取得します。
IDirectDraw7::Initialize CoCreateInstance COM 関数を使用して作成された DirectDraw オブジェクトを初期化します。
IDirectDraw7::RestoreAllSurfaces DirectDraw オブジェクトに対して作成されたすべてのサーフェスを、作成された順序で復元します。
IDirectDraw7::RestoreDisplayMode プライマリ サーフェスのディスプレイ デバイス ハードウェアのモードを、IDirectDraw7::SetDisplayMode メソッドが呼び出される前のモードにリセットします。 このメソッドを使用するには、排他的レベルのアクセスが必要です。
IDirectDraw7::SetCooperativeLevel アプリケーションの最上位の動作を決定します。
IDirectDraw7::SetDisplayMode ディスプレイ デバイス ハードウェアのモードを設定します。
IDirectDraw7::StartModeTest 現在のディスプレイ アダプターとモニターの組み合わせの更新レート情報を使用してシステム レジストリを更新するテストを開始します。
IDirectDraw7::TestCooperativeLevel ウィンドウまたは全画面表示アプリケーションの DirectDraw デバイスの現在の協調レベルの状態を報告します。
IDirectDraw7::WaitForVerticalBlank アプリケーションが垂直方向の空白間隔と同期するのに役立ちます。

注釈

IDirectDraw7 インターフェイスのメソッドは、次のグループに編成できます。

グループ	メソッド
メモリの割り当て	コンパクト 化と 初期化
協調レベル	SetCooperativeLevel と TestCooperativeLevel
オブジェクトの作成	CreateClipper、 CreatePalette、 CreateSurface
デバイスの機能	GetCaps
表示モード	EnumDisplayModes、 GetDisplayMode、 GetMonitorFrequency、 RestoreDisplayMode、 SetDisplayMode、 WaitForVerticalBlank
状態の表示	GetScanLine と GetVerticalBlankStatus
その他	EvaluateMode、 GetAvailableVidMem、 GetDeviceIdentifier、 GetFourCCCodes、 StartModeTest
Surface 管理	DuplicateSurface、 EnumSurfaces、 FlipToGDISurface、 GetGDISurface、 GetSurfaceFromDC、 RestoreAllSurfaces

 

IDirectDraw7 インターフェイスは、以前のバージョンよりも柔軟なサーフェス管理を可能にするメソッドを提供することで、インターフェイスの以前のバージョンの機能を拡張します。 IDirectDraw7 インターフェイス内のすべてのサーフェス関連メソッドは、IDirectDraw2 インターフェイスの対応するメソッドとは若干異なるパラメーターを受け取ります。 IDirectDraw2 インターフェイス メソッドが DDSURFACEDESC 構造体を受け入れて IDirectDrawSurface3 インターフェイスを取得する場合は、IDirectDraw7 のメソッドは DDSURFACEDESC2 構造体を受け入れ、代わりに IDirectDrawSurface7 インターフェイスを取得します。

IDirectDraw7 では 、子オブジェクトの有効期間を決定する COM ルールへのコンプライアンスが強化されています。

LPDIRECTDRAW、LPDIRECTDRAW2、LPDIRECTDRAW4、または LPDIRECTDRAW7 データ型を使用して、IDirectDraw、IDirectDraw2、IDirectDraw4、または IDirectDraw7 インターフェイスへのポインターを含む変数を宣言します。 Ddraw.h ヘッダー ファイルは、次のコードを使用してこれらのデータ型を宣言します。

typedef struct IDirectDraw     FAR *LPDIRECTDRAW;
typedef struct IDirectDraw2    FAR *LPDIRECTDRAW2;
typedef struct IDirectDraw4    FAR *LPDIRECTDRAW4;
typedef struct IDirectDraw7    FAR *LPDIRECTDRAW7;

要件

対象プラットフォーム	Windows
ヘッダー	ddraw.h