Platform SDK: DirectX

IDirectDraw7::DuplicateSurface

IDirectDraw7::DuplicateSurface メソッドは、DirectDrawSurface オブジェクトを複製する。

HRESULT DuplicateSurface(
  LPDIRECTDRAWSURFACE7 lpDDSurface,             
  LPLPDIRECTDRAWSURFACE7 FAR *lplpDupDDSurface  
);

パラメータ

lpDDSurface
複製するサーフェスの IDirectDrawSurface7 インターフェイスのアドレス。
lplpDupDDSurface
新しく複製する DirectDrawSurface オブジェクトの IDirectDrawSurface7 インターフェイスを格納する変数のアドレス。

戻り値

成功すれば、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 で宣言。