# 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

`TimerSignalAfterDelayVBL`, TimerSignalHeartbeatVBL