TimerServicesStartup

Starts the TimerServices thread.

Synopsis

Err TimerServicesStartup (int32 delta_priority)

Description

Starts the timer services thread. The thread's priority is set to your task's priority plus the delta_priority. After calling this function, your task and all its child threads can use timer services.

The service thread doesn't use many CPU cycles, and it uses them only when you make requests for services and when time events occur. Generally, you should run the service thread at a slightly higher priority than the rest of your tasks/threads, especially if timely notifications are critical.

If this function returns positive 1, that indicates that someone else has already started the service thread. In this case, you should respond by calling TimerServicesOpen() to connect with the already-running thread.

Arguments

delta_priority: A value added to your task's priority, the value becomes the thread's priority.

Return Value

Zero on success, one if the thread is already running, or a negative error code.

Implementation

Library call implemented in lib3do.lib.

Associated Files

lib3do.lib, timerutils.h