IDirectDrawSurface7::EnumAttachedSurfaces method (ddraw.h)
Enumerates all the surfaces that are attached to this surface.
HRESULT EnumAttachedSurfaces( LPVOID , LPDDENUMSURFACESCALLBACK7 );
Address of the application-defined structure that is passed to the enumeration member every time that it is called.
Address of the EnumSurfacesCallback7 function to be called for each surface that is attached to this surface.
If the method succeeds, the return value is DD_OK.
If it fails, the method can return one of the following error values:
EnumAttachedSurfaces enumerates only those surfaces that are directly attached to this surface. For example, in a flipping chain of three or more surfaces, only one surface is enumerated because each surface is attached only to the next surface in the flipping chain. In such a configuration, you can call EnumAttachedSurfaces on each successive surface to walk the entire flipping chain.
EnumAttachedSurfaces differs from its counterparts in previous interface versions in that it accepts a pointer to an EnumSurfacesCallback7 function, rather than an EnumSurfacesCallback or EnumSurfacesCallback2 function.