IDirectDraw::WaitForVerticalBlank
This method helps the application synchronize itself with the vertical-blank interval.
HRESULT WaitForVerticalBlank(
DWORD dwFlags,
HANDLE hEvent
);
Parameters
dwFlags
Determines how long to wait for the vertical blank. The following table shows the possible flags.Flag Description DDWAITVB_BLOCKBEGIN Returns when the vertical-blank interval begins. DDWAITVB_BLOCKEND Returns when the vertical-blank interval ends and the display begins. hEvent
Handle of the event to be triggered when the vertical blank begins. This parameter is not currently used.
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 |
DDERR_UNSUPPORTED |
DDERR_WASSTILLDRAWING |
Remarks
In a preemptive multithreaded environment, it is unlikely that the IDirectDraw::WaitForVerticalBlank method can synchronize with the vertical-blank interval.
Instead, use appropriate wait flags to time blits and flips.
Requirements
Pocket PC: Windows Mobile 5.0 and later
Smartphone: Windows Mobile 5.0 and later
OS Versions: Windows CE 5.01 and later
Header: Ddraw.h.
Library: Ddraw.lib.
See Also
IDirectDraw::GetVerticalBlankStatus | IDirectDraw::GetScanLine
Send Feedback on this topic to the authors