Edit

Share via

IDirectDraw7::WaitForVerticalBlank method (ddraw.h)

  • Article

Helps the application synchronize itself with the vertical-blank interval.

Syntax

HRESULT WaitForVerticalBlank(
  [in] DWORD  unnamedParam1,
  [in] HANDLE unnamedParam2
);

Parameters

[in] unnamedParam1

One of the following flags that indicates how long to wait for the vertical blank:

DDWAITVB_BLOCKBEGIN

WaitForVerticalBlank returns when the vertical-blank interval begins.

DDWAITVB_BLOCKBEGINEVENT

Triggers an event when the vertical blank begins. This value is not currently supported.

DDWAITVB_BLOCKEND

WaitForVerticalBlank returns when the vertical-blank interval ends and the display begins.

[in] unnamedParam2

Handle of the event to be triggered when the vertical blank begins. This parameter is not currently used.

Return value

If the method succeeds, the return value is DD_OK.

If it fails, the method can return one of the following error values:

  • DDERR_INVALIDOBJECT
  • DDERR_INVALIDPARAMS
  • DDERR_UNSUPPORTED
  • DDERR_WASSTILLDRAWING

Requirements

Requirement Value
Target Platform Windows
Header ddraw.h
Library Ddraw.lib
DLL Ddraw.dll

See also

IDirectDraw7