IDirectDrawSurface7::AddAttachedSurface 方法 (ddraw.h)
將指定的 z 緩衝區表面附加至這個表面。
語法
HRESULT AddAttachedSurface(
[in] LPDIRECTDRAWSURFACE7 unnamedParam1
);
參數
[in] unnamedParam1
要連接介面的 IDirectDrawSurface7 介面位址。
傳回值
如果方法成功,傳回值會DD_OK。
如果失敗,方法可以傳回下列其中一個錯誤值:
- DDERR_CANNOTATTACHSURFACE
- DDERR_GENERIC
- DDERR_INVALIDOBJECT
- DDERR_INVALIDPARAMS
- DDERR_SURFACEALREADYATTACHED
- DDERR_SURFACELOST
- DDERR_WASSTILLDRAWING
備註
AddAttachedSurface 會遞增所附加表面的參考計數。 您可以使用 IDirectDrawSurface7::D eleteAttachedSurface 方法,明確地取消連接表面並遞減其參考計數。 不同於您使用單一呼叫 IDirectDraw7::CreateSurface 所建立的複雜表面,不會自動釋放與此方法連結的介面。 應用程式必須釋放這類表面。
您只能使用此方法附加 z 緩衝區表面。
規格需求
需求 | 值 |
---|---|
目標平台 | Windows |
標頭 | ddraw.h |
程式庫 | Ddraw.lib |
Dll | Ddraw.dll |