Platform SDK: DirectX

IDirectDrawSurface7::AddAttachedSurface

IDirectDrawSurface7::AddAttachedSurface メソッドは、指定した Z バッファのサーフェスをこのサーフェスにアタッチする。

HRESULT AddAttachedSurface( 
  LPDIRECTDRAWSURFACE7 lpDDSAttachedSurface  
);

パラメータ

lpDDSAttachedSurface
サーフェスをアタッチする IDirectDrawSurface7 インターフェイスのアドレス。

戻り値

成功すれば、DD_OK を返す。

失敗すれば、以下のエラー値のいずれかを返す。

DDERR_CANNOTATTACHSURFACE
DDERR_GENERIC
DDERR_INVALIDOBJECT
DDERR_INVALIDPARAMS
DDERR_SURFACEALREADYATTACHED
DDERR_SURFACELOST
DDERR_WASSTILLDRAWING

注意

このメソッドは、アタッチされるサーフェスの参照カウントをインクリメントする。明示的にサーフェスのアタッチを解除して、参照カウントをデクリメントするには、IDirectDrawSurface7::DeleteAttachedSurface メソッドを使用する。IDirectDraw7::CreateSurface の単一の呼び出しで作成する複合サーフェス とは異なり、このメソッドでアタッチするサーフェスは自動的に解放されない。このようなサーフェスの解放は、アプリケーションの責任となる。

このメソッドでアタッチできるのは、Z バッファのサーフェスのみである。

動作環境

  Windows NT/2000 :Windows 2000 が必要。
  Windows 95/98 : Windows 98 が必要。
  ヘッダー : ddraw.h で宣言。

参照

IDirectDrawSurface7::DeleteAttachedSurfaceIDirectDrawSurface7::EnumAttachedSurfaces