SignalAtTime

Requests a wake-up call at a given time.

Synopsis

Err SignalAtTime (Item Cue, AudioTime Time)

Description

This function requests that a signal be sent to the calling item at the specified audio time. The cue item can be created using CreateCue().

A task can get the cue's signal mask using GetCueSignal(). The task can then call WaitSignal() to enter wait state until the cue's signal is sent at the specified time.

If you need to, you can call AbortTimerCue() to cancel the timer request before completion.

See the test program "ta_timer.c" for a complete example.

Arguments

Cue: Item number of a cue.

Time: The time at which to send a signal to the calling task.

Return Value

The function returns a non-negative value if successful or an error code (a negative value) if an error occurs.

Implementation

SWI implemented in Audio folio V20.

Associated Files

audio.h