public:
     virtual bool __fastcall DeleteAttachedSurface( TDx_DrawSurface* pAttachedSurface );

• Description
• Parameters
• See Also

If you would like to submit additions or improvements to this page, click: admin@bcb-tools.com.

The TDx_DrawSurface::DeleteAttachedSurface method will detach attached surfaces, decrementing the reference count of the surface.

Surfaces that are detached are not released unless their reference count is reduced to 0.

This method will only detach attachments explicitly formed using TDx_DrawSurface::AddAttachedSurface().

Removing surfaces from a chain may change the attachment order or designation of the surfaces remaining in that chain.

For example, removing a front buffer causes the next surface in the chain to become the front buffer and the surface after that to become the back buffer.
Detaching a back buffer causes the next surface in the chain to become the back buffer while detaching a plain surface merely shortens the chain.
Detaching a surface from a chain containing two surfaces will destroy the chain and return the surfaces to the designations they had prior to being placed in the chain.

If the method call fails, the OnError event will be triggered with one of the following values:
DDERR_CANNOTDETACHSURFACE
DDERR_INVALIDOBJECT
DDERR_INVALIDPARAMS
DDERR_SURFACELOST
DDERR_SURFACENOTATTACHED

AttachedSurface
The AttachedSurface parameter references the surface that is to be detached.
Set this parameter to NULL to detach all attached surfaces.

TDx_DrawSurface
TDx_DrawSurface::OnSurfaceLost()