====== TimerSignalAtTimeVBL ======

Sends a signal at the specified VBL.

==== Synopsis ====

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

==== Description ====

Creates a timer that notifies you by signal at the specified VBL time. 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, 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** VBL field count at which the event occurs.

==== 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:01ldo195#xref37512|''%%TimerSignalAfterDelayVBL%%'']], [[:documentation:development:opera:pf25:ppgfldr:smmfldr:ldofldr:01ldo199#xref31940|TimerSignalHeartbeatVBL]]