IDirectDrawVideoPort::Flip

  • Article

This method 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 IDirectDrawSurface interface 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. The following table shows the possible flags.
    Flag Description
    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::Flip are asynchronous. The actual flip operation will always be synchronized with the vertical blank of the video signal.

Requirements

OS Versions: Windows CE 2.12 and later. Version 2.12 requires DXPAK 1.0 or later.
Header: Dvp.h.
Link Library: Ddraw.lib.

 Last updated on Thursday, April 08, 2004

© 1992-2003 Microsoft Corporation. All rights reserved.