Platform SDK: DirectX |
IDirectDraw7::DuplicateSurface メソッドは、DirectDrawSurface オブジェクトを複製する。
HRESULT DuplicateSurface( LPDIRECTDRAWSURFACE7 lpDDSurface, LPLPDIRECTDRAWSURFACE7 FAR *lplpDupDDSurface );
成功すれば、DD_OK を返す。
失敗すれば、以下のエラー値のいずれかを返す。
DDERR_CANTDUPLICATE |
DDERR_INVALIDOBJECT |
DDERR_INVALIDPARAMS |
DDERR_OUTOFMEMORY |
DDERR_SURFACELOST |
このメソッドは、既存の DirectDrawSurface オブジェクトとして、同じサーフェス メモリを指す新しい DirectDrawSurface オブジェクトを作成する。この複製は、元のオブジェクトとまったく同じように使用できる。最後に参照したオブジェクトが解放されると、サーフェス メモリは解放される。プライマリ サーフェス、3D サーフェス、または暗黙的に作成されたサーフェスは複製できない。
Windows NT/2000 :Windows 2000 が必要。
Windows 95/98 : Windows 98 が必要。
ヘッダー : ddraw.h で宣言。