TimerMsgAfterDelayVBL

Sends a message after the specified number of VBLs occur.

TimerHandle TimerMsgAfterDelayVBL (Item msgport, uint32 fields, uint32 userdata1, uint32 userdata2)

This function creates a timer that notifies you by message 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.

• msgport Port to which the notification message is sent.

• fields Number of VBLs to occur before sending the message.

• userdata1 Value passed back to you in the msg_DataPtr field of the notification message.

• userdata2 Value passed back to you in the msg_DataSize field of the notification message.

A TimerHandle (a positive value) on success or a negative error code.

Library call implemented in lib3do.lib.

lib3do.lib, timerutils.h

TimerMsgAtTimeVBL, TimerMsgHeartbeatVBL