Platform SDK: DirectX |
DirectDraw7.DuplicateSurface メソッドは、DirectDrawSurface7 オブジェクトを複製する。
object.DuplicateSurface( _ ddIn As DirectDrawSurface7) As DirectDrawSurface7
成功すれば、新しく複製された DirectDrawSurface7 オブジェクトを返す。
失敗すればエラーが発生し、Err.Number に次のいずれかの値が設定される。
DDERR_CANTDUPLICATE |
DDERR_INVALIDOBJECT |
DDERR_INVALIDPARAMS |
DDERR_OUTOFMEMORY |
DDERR_SURFACELOST |
このメソッドは、既存の DirectDrawSurface オブジェクトとして、同じサーフェス メモリを指す新しい オブジェクトを作成する。この複製は、元のオブジェクトとまったく同じように使用できる。最後に参照されたオブジェクトが解放されると、サーフェス メモリが解放される。プライマリ サーフェス、3-D サーフェス、または暗に作成されたサーフェスは複製できない。