PDD_VPORTCB_GETFLIPSTATUS callback function

The DdVideoPortGetFlipStatus callback function determines whether the most recently requested flip on a surface has occurred.

Syntax


PDD_VPORTCB_GETFLIPSTATUS DdVideoPortGetFlipStatus;

DWORD APIENTRY DdVideoPortGetFlipStatus(
   PDD_GETVPORTFLIPSTATUSDATA lpGetFlipStatus
)
{ ... }

Parameters

lpGetFlipStatus

Points to a DD_GETVPORTFLIPSTATUSDATA structure that contains the information required for the driver to determine a surface's flip status.

Return value

DdVideoPortGetFlipStatus returns one of the following callback codes:

DDHAL_DRIVER_HANDLED
DDHAL_DRIVER_NOTHANDLED

Remarks

DirectDraw drivers that support VPE must implement DdVideoPortGetFlipStatus.

The driver should set the ddRVal member of the DD_GETVPORTFLIPSTATUSDATA structure at lpGetFlipStatus to DDERR_WASSTILLDRAWING and return DDHAL_DRIVER_HANDLED if a flip is currently in progress; otherwise the driver should set ddRVal to DD_OK and return DDHAL_DRIVER_HANDLED.

If the driver sets ddRVal to DDERR_WASSTILLDRAWING, DirectDraw will fail locks and blits on that surface.

Requirements

Target platform

Desktop

Header

Ddrawint.h (include Winddi.h)

See also

DD_GETVPORTFLIPSTATUSDATA

 

 

Send comments about this topic to Microsoft

Show: