Platform SDK: DirectX

DirectDraw7.DuplicateSurface

DirectDraw7.DuplicateSurface メソッドは、DirectDrawSurface7 オブジェクトを複製する。

object.DuplicateSurface( _ 
    ddIn As DirectDrawSurface7) As DirectDrawSurface7

パラメータ

object
DirectDraw7 オブジェクトを表すオブジェクト式。
ddIn
複製されるサーフェスになる DirectDrawSurface7 オブジェクト。

戻り値

成功すれば、新しく複製された DirectDrawSurface7 オブジェクトを返す。

エラー コード

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

DDERR_CANTDUPLICATE
DDERR_INVALIDOBJECT
DDERR_INVALIDPARAMS
DDERR_OUTOFMEMORY
DDERR_SURFACELOST

注意

このメソッドは、既存の DirectDrawSurface オブジェクトとして、同じサーフェス メモリを指す新しい オブジェクトを作成する。この複製は、元のオブジェクトとまったく同じように使用できる。最後に参照されたオブジェクトが解放されると、サーフェス メモリが解放される。プライマリ サーフェス、3-D サーフェス、または暗に作成されたサーフェスは複製できない。