Platform SDK: DirectX |
IDirectDrawSurface7::AddAttachedSurface メソッドは、指定した Z バッファのサーフェスをこのサーフェスにアタッチする。
HRESULT AddAttachedSurface( LPDIRECTDRAWSURFACE7 lpDDSAttachedSurface );
成功すれば、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::DeleteAttachedSurface、IDirectDrawSurface7::EnumAttachedSurfaces