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-File5.12.17  Pnice                                                     TOS

 Name:         »Pnice« - Alter priority of the calling process.

 Opcode:       266

 Syntax:       int16_t Pnice ( int16_t delta );

 Description:  The function Pnice alters the priority of the process 
               calling it by the value delta. A higher priority means 
               that the process receives a larger time-slice, i.e. it 
               is not switched over so often. In the same way, a lower 
               priority means that the time-slice of the process is 
               reduced, and so it must yield time to the CPU more 
               often.

               For the parameter delta the following must apply:(!nl) 
               - 20 <= delta <= 20.

               The function Pnice corresponds to Prenice (Pgetpid, 
               delta) and is implemented for backwards compatibility.

 Return value: The function returns the current process switching 
               priority. This is set to 0 by default. Higher or lower 
               values mean that the process is allocated respectively 
               a larger or smaller time-slice.

 Availability: As of the first in MultiTOS integrated MiNT version 
               1.04.

 Group:        Process functions

 See also:     Binding   Prenice