WaitVBLDefer

Synopsis

Err WaitVBLDefer (Item ioreq,uint32 numfields)

Description

This convenience call 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.

This call differs from WaitVBL() because it does not wait for the operation to complete. Instead, control returns to the calling application immediately, which can do more work while the I/O request is in the queue. When using the deferred version of the request, WaitIO() should be used when you want to wait for the completion of the I/O request.

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.

Implementation

Convenience call implemented in graphics.lib V20.

Associated Files

graphics.h, graphics.lib