====== TimerSignalAfterDelayVBL ======

Sends a signal after the specified number of VBLs occur.

==== Synopsis ====

''%%TimerHandle TimerSignalAfterDelayVBL (int32 signal, uint32 fields)%%''

==== Description ====

Creates a timer that notifies you by signal after the specified number of VBLs have occurred. The timer is a one-shot; after sending a notification message the timer enters a suspended state. Use ''%%TimerReset()%%'' to reactivate the timer using new time values, ''%%TimerRestart()%%'' to start another delay period of the same length as last time, or ''%%TimerCancel()%%'' to delete the timer.

The TimerServices thread must be active before calling this function.

==== Arguments ====

  * **signal** Signal to send to your task.

  * **fields** Number of VBLs to occur before sending the message.

==== Return Value ====

A TimerHandle (a positive value) on success or a negative error code.

==== Implementation ====

Library call implemented in lib3do.lib.

==== Associated Files ====

lib3do.lib, timerutils.h

==== See Also ====

[[:documentation:development:opera:pf25:ppgfldr:smmfldr:ldofldr:01ldo197#xref41366|''%%TimerSignalAtTimeVBL%%'']], [[:documentation:development:opera:pf25:ppgfldr:smmfldr:ldofldr:01ldo199#xref31940|TimerSignalHeartbeatVBL]]