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.13  Pgetpriority                                              TOS

 Name:         »Pgetpriority« - Get the current priority value for a 
               process.

 Opcode:       344 (0x0158)

 Syntax:       int32_t Pgetpriority ( int16_t which, int16_t who);

 Description:  The function Pgetpriority obtains the priority of the 
               processes specified by which and who. The 
               interpretation of parameter who depends on which:

               PRIO_PROCESS (0) reads the priority of process with 
               process ID which. A who of 0 implies the process id of 
               the calling process.

               PRIO_PGRP (1) reads the priority of the process group 
               with process group ID who. If the priorities of the 
               process differ, the lowest valued priority (i.e. the 
               highest CPU usage priority) is returned. A who of 0 
               implies the process group id of the calling process.

               PRIO_USER (2) reads the priority of the process of the 
               user with user ID who. For multiple processes the 
               lowest valued priority is returned. A who of 0 implies 
               the user id of the calling process.

               Library functions should first check for an error 
               condition and then decrement the returned value by 20.

               This call makes calls Pnice and Prenice obsolete.

 Return value: Return value is either a negative error number in case 
               of failure or the requested priority + 20 on success.

 Availability: MiNT 1.15.0

 Group:        Process functions

 See also:     Binding   Psetpriority