TimerSignalAtTime

Sends a signal at the specified time.

Synopsis

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

Description

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.

Arguments

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.

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