Topic       : TOS - The Operating System
Author      : 
Version     : tos.hyp (December 19, 2008)
Subject     : Programmieren/Atari
Nodes       : 3010
Index Size  : 93790
HCP-Version : 5
Compiled on : Atari
@charset    : atarist
@lang       : 
@default    : Title
@help       : 
@options    : +g -i -s +x +zz -t4
@width      : 70
View Ref-File8.7.7  evnt_timer                                                  TOS

 Name:         »Event Timer« - Wait for a given time interval.

 Opcode:       24

 Syntax:       int16_t evnt_timer ( int16_t ev_tlocount, int16_t 
               ev_thicount );

 Description:  The call evnt_timer waits until a given time has passed 
               before releasing control to the operating system. The 
               following apply:

                Parameter    Meaning

                ev_tlocount  Low-WORD of time value in milliseconds
                ev_thicount  High-WORD of time value in milliseconds

               Note: One should always use this function for delay 
               loops in programs. The operating system can then 
               allocate the CPU to another process (even without real 
               multitasking).

               Under TOS 1.0, neither parameter may be set to 0 for a 
               desk accessory, otherwise the system will hang.

               This function cannot be relied on as an accurate clock. 
               The specified time is only the minimum time value, with 
               the function returning at some point after this time 
               has passed.

 Return value: This is always the value 1.

 Availability: All AES versions.

 Group:        Event library

 See Also:     Binding   Messages