TimerMsgAfterDelay

Sends a message after a delay.

Synopsis

TimerHandle TimerMsgAfterDelay (Item msgport, uint32 seconds, uint32 microseconds, uint32 userdata1, uint32 userdata2)

Description

Creates a timer that notifies you by message after the specified delay. 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

msgport: Port to which the notification message is sent.

seconds: Seconds portion of the delay.

microseconds: Microseconds portion of the delay. This value can be larger than 1 million.

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.

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