Platform SDK: DirectX

DirectDrawSurface7.GetAttachedSurface

DirectDrawSurface7.GetAttachedSurface メソッドは、指定した能力を持つアタッチされたサーフェスを取得する。

object.GetAttachedSurface( _ 
    caps As DDSCAPS2) As DirectDrawSurface7

パラメータ

object
DirectDrawSurface7 オブジェクトを表すオブジェクト式。
caps
サーフェスのハードウェア能力を含む DDSCAPS2 型。

戻り値

成功すれば、DirectDrawSurface7 オブジェクトを返す。取得するサーフェスは、caps パラメータの記述に適合するものである。

エラー コード

失敗すればエラーが発生し、Err.Number に次のいずれかの値が設定される。

DDERR_INVALIDOBJECT
DDERR_INVALIDPARAMS
DDERR_NOTFOUND
DDERR_SURFACELOST

注意

アタッチは、複数の DirectDrawSurface オブジェクトを複合型に接続するために使用される。複合型は、Z バッファと共に 3D ページ フリッピングをサポートするために必要な型である。要求する能力に適合するアタッチされたサーフェスが 1 つ以上ある場合、このメソッドは失敗する。この場合、アプリケーションはアタッチされたサーフェスを取得するために、DirectDrawSurface7.GetAttachedSurfaceEnum メソッドを使用しなければならない。

このメソッドの成功により取得したオブジェクトは、DirectDrawSurface7 オブジェクト変数に割り当てなければならない。以下に例を示す。

Dim DDrawSurface as DirectDrawSurface7
Set DDrawSurface = object.GetAttachedSurface()