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

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

継承

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

メソッド

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

IDirectDrawSurface7::AddAttachedSurface 指定した z バッファー サーフェスをこのサーフェスにアタッチします。
IDirectDrawSurface7::AddOverlayDirtyRect IDirectDrawSurface7::AddOverlayDirtyRect メソッドは現在実装されていません。
IDirectDrawSurface7::Blt ビット ブロック転送 (bitblt) を実行します。 このメソッドは、ビットブレット操作中の z バッファリングまたはアルファ ブレンドをサポートしていません。
IDirectDrawSurface7::BltBatch IDirectDrawSurface7::BltBatch メソッドは現在実装されていません。
IDirectDrawSurface7::BltFast ソース カラー キーまたはコピー先のカラー キーを使用して、ソース コピービットまたは透明ビットレットを実行します。
IDirectDrawSurface7::ChangeUniquenessValue このサーフェスの一意性の値を手動で更新します。
IDirectDrawSurface7::D eleteAttachedSurface 1 つ以上のアタッチされたサーフェスをデタッチします。
IDirectDrawSurface7::EnumAttachedSurfaces このサーフェスにアタッチされているすべてのサーフェスを列挙します。
IDirectDrawSurface7::EnumOverlayZOrders 指定したコピー先のオーバーレイ サーフェスを列挙します。 オーバーレイは、前面から背面へ、または前に戻る順序で列挙できます。
IDirectDrawSurface7::Flip DDSCAPS_BACKBUFFER サーフェスに関連付けられているサーフェス メモリをフロント バッファー サーフェスに関連付けます。
IDirectDrawSurface7::FreePrivateData このサーフェスに関連付けられている指定されたプライベート データを解放します。
IDirectDrawSurface7::GetAttachedSurface 指定した機能を持つアタッチされたサーフェスを取得し、取得したインターフェイスの参照カウントをインクリメントします。
IDirectDrawSurface7::GetBltStatus ビット ブロック転送 (bitblt) 操作に関する状態を取得します。
IDirectDrawSurface7::GetCaps このサーフェスの機能を取得します。 これらの機能は、ディスプレイ デバイスの機能に必ずしも関連しているわけではありません。
IDirectDrawSurface7::GetClipper このサーフェスに関連付けられている DirectDrawClipper オブジェクトを取得し、返されるクリッパーの参照カウントをインクリメントします。
IDirectDrawSurface7::GetColorKey このサーフェスのカラー キー値を取得します。
IDirectDrawSurface7::GetDC この画面のデバイス コンテキストの GDI 互換ハンドルを作成します。
IDirectDrawSurface7::GetDDInterface このサーフェスの作成に使用された DirectDraw オブジェクトへのインターフェイスを取得します。
IDirectDrawSurface7::GetFlipStatus このサーフェスが反転処理を完了したかどうかに関する状態を取得します。
IDirectDrawSurface7::GetLOD マネージド ミップマップ サーフェスに現在設定されている最大詳細レベル (LOD) を取得します。 このメソッドは、マネージド テクスチャでのみ成功します。
IDirectDrawSurface7::GetOverlayPosition このサーフェスの表示座標を取得します。 このメソッドは、表示されているアクティブなオーバーレイ サーフェス (つまり、DDSCAPS_OVERLAY フラグが設定されたサーフェス) で使用されます。
IDirectDrawSurface7::GetPalette このサーフェスに関連付けられている DirectDrawPalette オブジェクトを取得し、返されるパレットの参照カウントをインクリメントします。
IDirectDrawSurface7::GetPixelFormat このサーフェスの色とピクセルの形式を取得します。
IDirectDrawSurface7::GetPriority このテクスチャのテクスチャ管理優先度を取得します。 このメソッドは、マネージド テクスチャでのみ成功します。
IDirectDrawSurface7::GetPrivateData このサーフェスに関連付けられているプライベート データを、指定されたバッファーにコピーします。
IDirectDrawSurface7::GetSurfaceDesc 現在の条件でこのサーフェスの説明を取得します。
IDirectDrawSurface7::GetUniquenessValue このサーフェスの現在の一意性値を取得します。
IDirectDrawSurface7::Initialize DirectDrawSurface オブジェクトを初期化します。
IDirectDrawSurface7::IsLost DirectDrawSurface オブジェクトに関連付けられているサーフェス メモリが解放されているかどうかを判断します。
IDirectDrawSurface7::Lock サーフェス メモリへのポインターを取得します。
IDirectDrawSurface7::P ageLock システム メモリとの間で直接メモリ アクセス (DMA) 転送を使用するビット ブロック転送 (bitblt) 操作が進行中である間に、システム メモリサーフェスがページアウトされないようにします。
IDirectDrawSurface7::P ageUnlock システム メモリ サーフェスのロックを解除し、ページアウトできるようにします。
IDirectDrawSurface7::ReleaseDC IDirectDrawSurface7::GetDC メソッドを使用して以前に取得したデバイス コンテキストのハンドルを解放します。
IDirectDrawSurface7::Restore 失われたサーフェスを復元します。 これは、DirectDrawSurface オブジェクトに関連付けられているサーフェス メモリが解放されたときに発生します。
IDirectDrawSurface7::SetClipper このサーフェスにクリッパー オブジェクトをアタッチするか、このサーフェスから削除します。
IDirectDrawSurface7::SetColorKey ハードウェアがサーフェスごとにカラー キーをサポートしている場合は、DirectDrawSurface オブジェクトのカラー キー値を設定します。
IDirectDrawSurface7::SetLOD マネージド ミップマップ サーフェスの最大詳細レベル (LOD) を設定します。 このメソッドは、マネージド テクスチャでのみ成功します。
IDirectDrawSurface7::SetOverlayPosition オーバーレイ サーフェスの表示座標を変更します。
IDirectDrawSurface7::SetPalette パレット オブジェクトをサーフェスにアタッチ (またはサーフェスからデタッチ) します。 サーフェスは、後続のすべての操作にこのパレットを使用します。 パレットの変更は、更新のタイミングに関係なく、すぐに行われます。
IDirectDrawSurface7::SetPriority このテクスチャのテクスチャ管理優先度を割り当てます。 このメソッドは、マネージド テクスチャでのみ成功します。
IDirectDrawSurface7::SetPrivateData DirectDraw ではなく、アプリケーションで使用することを目的としたサーフェスにデータを関連付けます。 データは値渡しされ、複数のデータ セットを 1 つのサーフェスに関連付けることができます。
IDirectDrawSurface7::SetSurfaceDesc 既存のサーフェスの特性を設定します。
IDirectDrawSurface7::Unlock 直接サーフェス操作が完了したことを DirectDraw に通知します。
IDirectDrawSurface7::UpdateOverlay オーバーレイ サーフェスのビジュアル属性を再配置または変更します。 これらのサーフェスには、DDSCAPS_OVERLAY フラグが設定されている必要があります。
IDirectDrawSurface7::UpdateOverlayDisplay IDirectDrawSurface7::UpdateOverlayDisplay メソッドは現在実装されていません。
IDirectDrawSurface7::UpdateOverlayZOrder オーバーレイの z オーダーを設定します。

注釈

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

グループ	メソッド
メモリの割り当て	Initialize、IsLost、Restore
サーフェスのアタッチ	AddAttachedSurface、 DeleteAttachedSurface、 EnumAttachedSurfaces、 GetAttachedSurface
BitBltting	Blt、 BltBatch、 BltFast、 GetBltStatus
色のキー設定	GetColorKey と SetColorKey
デバイス コンテキスト	GetDC と ReleaseDC
反転	Flip と GetFlipStatus
サーフェスのロック	Lock、 PageLock、 PageUnlock、 Unlock
その他	GetDDInterface
オーバーレイ	AddOverlayDirtyRect、 EnumOverlayZOrders、 GetOverlayPosition、 SetOverlayPosition、 UpdateOverlay、 UpdateOverlayDisplay、 UpdateOverlayZOrder
プライベート サーフェス データ	FreePrivateData、 GetPrivateData、 および SetPrivateData
Surface の機能	GetCaps
Surface Clipper	GetClipper と SetClipper
表面特性	ChangeUniquenessValue、 GetPixelFormat、 GetSurfaceDesc、 GetUniquenessValue、 および SetSurfaceDesc
サーフェス パレット	GetPalette と SetPalette
テクスチャ	GetLOD、 GetPriority、 SetLOD、 および SetPriority

 

IDirectDrawSurface7 インターフェイスは、より優れたサーフェス管理と使いやすさを提供するメソッドを提供することで、インターフェイスの以前のバージョンの機能を拡張します。 このインターフェイスの多くのメソッドは、以前のバージョンのインターフェイスで対応するパラメーターとは若干異なるパラメーターを受け取ります。 IDirectDrawSurface3 インターフェイス メソッドが DDSURFACEDESC 構造体または IDirectDrawSurface3 インターフェイスを受け入れる場合は、IDirectDrawSurface7 のメソッドは DDSURFACEDESC2 構造体または IDirectDrawSurface7 インターフェイスを受け入れます。

さまざまな DirectDrawSurface オブジェクト インターフェイスを指す変数を宣言するには、LPDIRECTDRAWSURFACE、LPDIRECTDRAWSURFACE2、LPDIRECTDRAWSURFACE3、LPDIRECTDRAWSURFACE4、または LPDIRECTDRAWSURFACE7 データ型を使用します。 Ddraw.h ヘッダー ファイルは、次のコードを使用してこれらのデータ型を宣言します。

typedef struct IDirectDrawSurface     FAR *LPDIRECTDRAWSURFACE;
typedef struct IDirectDrawSurface2    FAR *LPDIRECTDRAWSURFACE2;
typedef struct IDirectDrawSurface3    FAR *LPDIRECTDRAWSURFACE3;
typedef struct IDirectDrawSurface4    FAR *LPDIRECTDRAWSURFACE4;
typedef struct IDirectDrawSurface7    FAR *LPDIRECTDRAWSURFACE7;

要件

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