Platform SDK: DirectX |
The DirectDrawSurface7.Flip method makes the surface memory associated with the DDSCAPS_BACKBUFFER surface become associated with the front-buffer surface.
object.Flip( _ ddS As DirectDrawSurface7, _ flags As CONST_DDFLIPFLAGS)
If the method fails, it raises an error, and Err.Number can be set to one of the following values:
DDERR_GENERIC |
DDERR_INVALIDOBJECT |
DDERR_INVALIDPARAMS |
DDERR_NOFLIPHW |
DDERR_NOTFLIPPABLE |
DDERR_SURFACEBUSY |
DDERR_SURFACELOST |
DDERR_UNSUPPORTED |
DDERR_WASSTILLDRAWING |
This method can be called only for a surface that has the DDSCAPS_FLIP and DDSCAPS_FRONTBUFFER capabilities. The display memory previously associated with the front buffer is associated with the back buffer.
The ddS parameter is used in rare cases when the back buffer is not the buffer that should become the front buffer. Typically, this parameter is Nothing.
The DirectDrawSurface7.Flip method is always synchronized with the vertical blank. If the surface has been assigned to a video port, this method updates the visible overlay surface and the video port's target surface.
For more information, see Flipping Surfaces.