TimerSignalAfterDelayVBL

Sends a signal after the specified number of VBLs occur.

Synopsis

TimerHandle TimerSignalAfterDelayVBL (int32 signal, uint32 fields)

Description

Creates a timer that notifies you by signal after the specified number of VBLs have occurred. 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, TimerRestart() to start another delay period of the same length as last time, 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: Number of VBLs to occur before sending the message.

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