# 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

### See Also

``AbortTimerCue`(), CreateCue(), GetCueSignal(), SleepUntilTime(), GetAudioRate()`