IDirectDrawVideoPort::Flip

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 IDirectDrawVideoPort::Flipmethod instructs the DirectDrawVideoPort object to write the next frame of video to a new surface.

HRESULT Flip(
LPDIRECTDRAWSURFACE
lpDDSurface
,
DWORD
dwFlags
);

Parameters

lpDDSurface

Address of the IDirectDrawSurfaceinterface for the surface that will receive the next frame of video. Setting this parameter to NULL causes DirectDraw to cycle through surfaces in the flipping chain in the order they were attached.

dwFlags

Flip options flags. This parameter can be one of the following values:

DDVPFLIP_VIDEO	The specified surface is to receive the normal video data.
DDVPFLIP_VBI	The specified surface is to receive only the data within the vertical blanking interval.

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_INVALIDOBJECT

DDERR_INVALIDPARAMS

Remarks

This method can be used to prevent tearing. Calls to IDirectDrawVideoPort::Flipare asynchronous. The actual flip operation will always be synchronized with the vertical blank of the video signal.

Requirements

Runs on	Versions	Declared in	Link to
Windows CE OS	2.12 or later. Version 2.12 requires DXPAK 1.0 or later.	dvp.h	ddraw.lib