RT_ChangePriority (changes)
Showing changes from revision #0 to #1:
Added | Removed | Changed
RTSupport
» SWI Calls
» RT_ChangePriority
RT_ChangePriority
(SWI &575C4)
Change the priority of an existing real-time routine
| Entry | |
|---|---|
| R0 | flags (reserved, should be zero) |
| R1 | routine handle returned from RT_Register, or 0 to change the priority of the foreground process |
| R2 | new priority (as for RT_Register) |
| Exit | |
|---|---|
| R0 | previous priority level (as a number from 0-255) |
| – | All other registers are preserved |
Interrupts
- Interrupts are disabled
- Fast interrupts are enabled
Processor Mode
- Processor is in SVC mode
Re-entrancy
- SWI is re-entrant
Use
This SWI allows the priority setting of a routine to be changed on the fly, for example if process has become more time-critical, or if it is blocking a routine of a higher priority. It may cause a thread switch if a different thread is promoted above the priority of the current thread, or if the current thread is demoted below other unblocked threads.
The priority level of the foreground process may be changed, but this is only intended for short-term use and not when the foreground is in USR mode (otherwise system callbacks will also be promoted above some real-time threads, which is undesirable behaviour).
See also
Social
and
ROOL Store
Buy RISC OS Open merchandise here, including SD cards for Raspberry Pi and more.