Platform SDK: DirectX |
DirectDrawSurface7.GetAttachedSurface メソッドは、指定した能力を持つアタッチされたサーフェスを取得する。
object.GetAttachedSurface( _ caps As DDSCAPS2) As DirectDrawSurface7
成功すれば、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()