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