DirectX SDK

CONST_DDFLIPFLAGS

The CONST_DDFLIPFLAGS enumeration is used in the flags parameter of the DirectDrawSurface7.Flip method to specify flip options.

Enum CONST_DDFLIPFLAGS
    DDFLIP_DONOTWAIT  =         32
    DDFLIP_EVEN       =          2
    DDFLIP_INTERFVAL2 =  536870912
    DDFLIP_INTERFVAL3 =  805306368
    DDFLIP_INTERFVAL4 = 1073741824
    DDFLIP_NOVSYNC    =          8
    DDFLIP_ODD        =          4
    DDFLIP_WAIT       =          1
    DDFLIP_STEREO     =         16
End Enum

DDFLIP_DONOTWAIT: The default is DDFLIP_WAIT. If you want to override the default and use time when the accelerator is busy (as denoted by the DDERR_WASSTILLDRAWING error value), use DDFLIP_DONOTWAIT.
DDFLIP_EVEN: For use only when displaying video in an overlay surface. The new surface contains data from the even field of a video signal. This flag cannot be used with the DDFLIP_ODD flag.
DDFLIP_INTERFVAL2, DDFLIP_INTERFVAL3,
DDFLIP_INTERFVAL4: These flags indicate how many vertical retraces to wait between each flip. The default is 1. DirectDraw returns DERR_WASSTILLDRAWING for each surface involved in the flip until the specified number of vertical retraces has occurred. If DDFLIP_INTERFVAL2 is set, DirectDraw flips on every second vertical sync; if DDFLIP_INTERFVAL3, on every third sync; and if DDFLIP_INTERFVAL4, on every fourth sync.
These flags are effective only if DDCAPS2_FLIPINTERVAL is set in the DDCAPS type returned for the device.
DDFLIP_NOVSYNC: Causes DirectDraw to perform the physical flip as close as possible to the next scan line. Subsequent operations involving the two flipped surfaces do not check to see if the physical flip has finished—that is, they do not return DDERR_WASSTILLDRAWING for that reason (but may for other reasons). This allows an application to perform flips at a higher frequency than the monitor refresh rate, but might introduce visible artifacts.
If DDCAPS2_FLIPNOVSYNC is not set in the DDCAPS type returned for the device, DDFLIP_NOVSYNC has no effect.
DDFLIP_ODD: For use only when displaying video in an overlay surface. The new surface contains data from the odd field of a video signal. This flag cannot be used with the DDFLIP_EVEN flag.
DDFLIP_STEREO: DirectDraw flips and displays a main stereo surface. When this flag is set, stereo autoflipping is enabled. The hardware automatically flips between the left and right buffers during each screen refresh.
DDFLIP_WAIT: Typically, if the flip cannot be set up because the state of the display hardware is not appropriate, the DDERR_WASSTILLDRAWING error returns immediately, and no flip occurs. Setting this flag causes the method to continue trying to flip if it receives the DDERR_WASSTILLDRAWING error from the hardware abstraction layer (HAL). The method does not return until the flipping operation has been successfully set up, or another error, such as DDERR_SURFACEBUSY, is returned.