DDHAL_FLIPDATA (Windows CE 5.0)
This structure contains information needed to do a flip. This structure passes the information to the DirectDraw hardware abstraction layer (DDHAL) Flip callback function.
typedef struct _DDHAL_FLIPDATA {LPDDRAWI_DIRECTDRAW_GBLlpDD;LPDDRAWI_DDRAWSURFACE_LCLlpSurfCurr;LPDDRAWI_DDRAWSURFACE_LCLlpSurfTarg;DWORDdwFlags;HRESULTddRVal;LPDDHALSURFCB_FLIPFlip;} 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_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. 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_INTERVAL3 Indicates that DirectDraw will flip on every third vertical sync DDFLIP_INTERVAL4 Indicates that DirectDraw will flip on every fourth vertical sync. DDFLIP_NOVSYNC Causes DirectDraw to perform the physical flip immediately and return to the application. Typically, what was the front buffer, but is now the back buffer, will be visible until the next vertical retrace. However, the result depends on timing. Subsequent operations involving the two flipped surfaces will not check to see if the physical flip has finished. That is, those operations will not return DDERR_WASSTILLDRAWING as a result of checking, but may for other reasons. Not checking allows an application to perform flips at a higher frequency than the monitor refresh rate, but may introduce visible artifacts. This approach is only effective if the DDCAPS2_FLIPNOVSYNCflag is set. If that flag is not set, DDFLIP_NOVSYNC has no effect. DDFLIP_ODD Indicates that the target surface contains the odd field of video data. This flag is only valid with an overlay surface. ddRVal
Passes the DirectDraw return values.Flip
This member is used by DirectDraw and should not be filled in by the driver.
Requirements
OS Versions: Windows CE 2.12 and later. Version 2.12 requires DXPAK 1.0 or later.
Header: Ddrawi.h.
See Also
Flip | DDRAWI_DIRECTDRAW_GBL | DDRAWI_DDRAWSURFACE_LCL | DDERR_WASSTILLDRAWING | DirectDrawSurface Structures
Send Feedback on this topic to the authors