WaitVBL

Synopsis

Err WaitVBL (Item ioreq,uint32 numfields)

Description

This call is a convenience call that is not actually part of the Graphics folio. It is included here because it resides in the graphics.lib for the moment. It uses the timer device, which is completely independent of the Graphics folio.

This call allows a task to wait the specified number of VBLs. The I/O request argument is set up to use the timer device. The numfields argument is a count of the number of video fields for which the task must wait.

Arguments

ioreq: The item number of the I/O request.

numfields: Number of VBLs to wait.

Return Value

The call returns a non-negative value if successful or an error code (a negative value) if an error occurs.

Caveats

Because of the multitasking nature of the 3DO system, the task may not regain control until later than you may want.

Implementation

Convenience call implemented in graphics.lib V20.

Associated Files

graphics.h, graphics.lib