DDHAL_FLIPDATA (Compact 2013)

3/26/2014

This structure contains information needed to do a flip. This structure passes the information to the DirectDraw hardware abstraction layer (DDHAL) Flip callback function.

Syntax

typedef struct _DDHAL_FLIPDATA {
  LPDDRAWI_DIRECTDRAW_GBL lpDD;
  LPDDRAWI_DDRAWSURFACE_LCL lpSurfCurr;
  LPDDRAWI_DDRAWSURFACE_LCL lpSurfTarg;
  DWORD dwFlags;
  HRESULT ddRVal;
} DDHAL_FLIPDATA;

Members

• lpDD
  Pointer to the DDRAWI_DIRECTDRAW_GBL structure that represents the DirectDraw object.

• lpSurfCurr
  Pointer to the DDRAWI_DDRAWSURFACE_LCL structure that represents the current surface.

• lpSurfTarg
  Pointer to the DDRAWI_DDRAWSURFACE_LCL structure that represents the target surface, which is the surface to which the data will be flipped.

• dwFlags
  Flags specifying flip options.

  The following table shows the possible flags.

  Flag	Description
  DDFLIP_EVEN	Indicates that the target surface contains the even field of video data. This flag is only valid with an overlay surface.
  DDFLIP_INTERVAL1	Indicates that DirectDraw will flip on every sync.
  DDFLIP_INTERVAL2	Indicates that DirectDraw will flip on every other vertical sync. This flag and the following two flags indicate how many vertical retraces to wait between each flip. The default is one. DirectDraw will return DDERR_WASSTILLDRAWING for each surface involved in the flip until the specified number of vertical retraces has occurred. (DDERR_WASSTILLDRAWING indicates that the previous blit operation that is transferring information to or from this surface is incomplete.) These three flags are only effective if the DDCAPS2_FLIPINTERVAL flag is set. If that flag is not set, these three flags have no effect.
  DDFLIP_INTERVAL4	Indicates that DirectDraw will flip on every fourth vertical sync.
  DDFLIP_ODD	Indicates that the target surface contains the odd field of video data. This flag is only valid with an overlay surface.
  DDFLIP_WAITNOTBUSY	Indicates that the driver should wait until the hardware is not busy to perform the flip.
  DDFLIP_WAITVSYNC	Indicates that the driver should wait until the next vertical retrace to perform the flip.

• ddRVal
  Passes the DirectDraw return values.

Requirements

Header

ddrawi.h

See Also

Reference

DirectDrawSurface Structures
LPDDHALSURFCB_FLIP
DDRAWI_DIRECTDRAW_GBL
DDRAWI_DDRAWSURFACE_LCL
DDHAL Callback Return Values