Sends a signal at the specified time.

TimerHandle TimerSignalAtTime (int32 signal, uint32 seconds, uint32 microseconds)

This function creates a timer that notifies you by signal at the specified 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.

AtTime signals are useful primarily for synchronizing with real-world events. For a one-shot delay use TimerSignalDelay(). For a periodic series of signals, use TimerSignalHeartbeat().

The TimerServices thread must be active before calling this function.

• signal Signal to send to your task.

• seconds Seconds portion of the time.

• microseconds Microseconds portion of the time. This value can be larger than 1 million.

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

Library call implemented in lib3do.lib.

lib3do.lib, timerutils.h

''%%TimerSignalAfterDelay%%'', TimerSignalHeartbeat