Topic       : TOS - das Betriebssystem
Author      : 
Version     : tos.hyp (5. März 2013)
Subject     : Programmieren/Atari
Nodes       : 3001
Index Size  : 93602
HCP-Version : 5
Compiled on : Atari
@charset    : atarist
@lang       : 
@default    : Titel
@help       : 
@options    : +g -i -s +x +zz -t4
@width      : 70
View Ref-File5.10.7  Tsetitimer                                                 TOS

 Name:         »Tsetitimer« - steuert einen periodischen Timer.

 Gemdosnummer: 329 (0x0149)

 Deklaration:  int32_t Tsetitimer ( int16_t which, int32_t *interval, 
               int32_t *value, int32_t *ointerval, int32_t *ovalue );

 Beschreibung: Die GEMDOS-Routine Tsetitimer steuert einen von 
               insgesamt drei möglichen periodischen Timern. Es gilt:

                Parameter  Bedeutung

                which      gewünschter Timer
                            0 =  Dieser Timer arbeitet in Echtzeit, 
                                 und sendet nach Ablauf das Signal 
                                 SIGALRM.
                            1 =  Dieser Timer arbeitet in 'virtueller 
                                 Prozess-Zeit', und sendet nach Ablauf 
                                 das Signal SIGVTALRM. Der Timer läuft 
                                 in diesem Fall nur, wenn der Prozess, 
                                 welcher den Timer steuert, aktuell 
                                 die CPU besitzt.
                            2 =  Dieser Timer arbeitet sowohl in 
                                 'virtueller Prozess-Zeit' als auch 
                                 dann, wenn das Betriebssystem selbst 
                                 aktiv ist. Nach Ablauf des Timers 
                                 wird das Signal SIGPROF gesendet.
                interval   Adresse eines Long-Wertes, welcher den Wert 
                           enthält, auf den der Timer nach Ablauf 
                           gesetzt werden soll. Ein NULL-Zeiger 
                           bedeutet, daß der entsprechende alte Wert 
                           nicht verändert werden soll. Falls der 
                           int32_t-Wert den Wert 0 besitzt, wird der 
                           Timer nach seinem Ablauf deaktiviert.
                value      Adresse eines Long-Wertes, welcher den 
                           Initialwert des Timers in Millisekunden 
                           beschreibt. Ein NULL-Zeiger läßt den 
                           aktuellen Timer unangetastet. Falls der 
                           int32_t-Wert den Wert 0 besitzt, wird der 
                           Timer deaktiviert.
                ointerval  Adresse eines Long-Wertes, welcher das 
                           aktuelle Intervall des Timers aufnimmt, 
                           bzw. NULL, wenn dieser Wert nicht von 
                           Interesse ist.
                ovalue     Adresse eines Long-Wertes, welcher den 
                           aktuellen Wert des Timers aufnimmt oder 
                           NULL, wenn dieser Wert nicht von Interesse 
                           ist.

               Da alle internen Berechnungen in Millisekunden gemessen 
               werden, ist es nicht möglich einen Timer auf beliebige 
               (sehr große, zukünftige) Werte zu setzen.

               Setting new interval values needs root privileges.

 Ergebnis:     Die Funktion liefert bei korrekter Ausführung 0, und im 
               Fehlerfall einen negativen Wert zurück.

 Verfügbar:    Diese Funktion ist optional, daher darf ein Aufruf mit 
               EINVFN beantwortet werden. Sie ist verfügbar, wenn 
               'MiNT' Cookie mit einer Versionsnummer von mindestens 
               1.11 existiert.

 Gruppe:       Datum und Uhrzeit

 Querverweis:  Binding   Pause   Psignal   Talarm