 Important: |
|---|
| This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist. |
The IDirectDrawSurface5::DeleteAttachedSurfacemethod detaches two attached surfaces.
HRESULT DeleteAttachedSurface( DWORD dwFlags , LPDIRECTDRAWSURFACE4 lpDDSAttachedSurface );
Parameters
- dwFlags
- This parameter is currently not used and must be set to zero.
- lpDDSAttachedSurface
- Address of the
IDirectDrawSurface5interface for the DirectDrawSurface object
to be detached. If this parameter is NULL, all attached surfaces
are detached.
Return Values
If the method succeeds, the return value is DD_OK.
If the method fails, the return value may be one of the following error values:
DDERR_CANNOTDETACHSURFACE DDERR_INVALIDOBJECT DDERR_INVALIDPARAMS DDERR_SURFACELOST DDERR_SURFACENOTATTACHED Remarks
This method decrements the reference count of the surface being detached. If the reference count of the surface being detached reaches zero, it is lost and removed from memory.
Using AddAttachedSurfaceor DeleteAttachedSurfaceon any surface in a flipping chain is not supported. It may work, but it is likely that memory leaks will result. The functions are primarily provided for future expansion. As a workaround, initially create surfaces in flipping chains with the desired number of buffers.
Requirements
Runs on Versions Declared in Link to Windows CE OS 2.12 or later. Version 2.12 requires DXPAK 1.0 or later. ddraw.h ddraw.lib