|
www.riscos.com Technical Support: |
The Task Manager module provides various facilities to ease the management of tasks. These are:
The Task Manager module is not available in RISC OS 2.
R0 = task handle
R0 = pointer to task name
Interrupt status is undefined
Fast interrupts are enabled
Processor is in SVC mode
SWI is re-entrant
This call returns the name of a task, given its task handle. If you wish to keep the name, you must copy it into your own workspace.
None
R0 = 0 for first call, or value from previous call
R1 = pointer to word aligned buffer
R2 = buffer length (in bytes)
R0 = value to pass to next call, or < 0 if no more entries
R1 = pointer to first unused word in buffer
R2 = number of unused bytes in buffer
Interrupt status is undefined
Fast interrupts are enabled
Processor is in SVC mode
SWI is not re-entrant
This call enumerates all the currently active tasks. On exit the buffer is filled with entries of the form:
| Byte | Meaning | |
|---|---|---|
| 0 | task handle | |
| 4 | pointer to task name (should be copied away and not used in place) | |
| 8 | amount of memory (in K) used by the task | |
| 12 | flags: | |
| Bit 0 | 0  application task1 module task
| |
| Bit 1 | 0 slot bar cannot be dragged 1 slot bar can be dragged
| |
| (Bits 2-31 are reserved, and are currently 0) | ||
R0 = shutdown flags
--
Interrupt status is undefined
Fast interrupts are enabled
Processor is in SVC mode
SWI is not re-entrant
This call initiates a desktop shutdown. The actions performed are controlled by the shutdown flags held in R0:
| Bit | Meaning when set |
|---|---|
| 0 | don't display restart dialogue (equivalent to Exit menu option) |
| 1 | don't broadcast Message_PreQuit (see Message_PreQuit (8)) |
| 2 | flag in CMOS as portable power-down |
| 3 | send a Message_Shutdown (see Message_Shutdown (14)) |
| 4 | reject OS_UpCall 1 and 2 (see OS_UpCall 1 and 2) |
| 5 - 31 | reserved (must be zero) |
None
Changes the size of the font cache, system sprite area and/or RAM disc
*ChangeDynamicArea [-FontSize n[K]] [-SpriteSize n[K]] [-RamFsSize n[K]]
n - Size of the area to be set, in kilobytes
*ChangeDynamicArea changes the size of the font cache, system sprite area and/or RAM disc. It generates an error if it is unable to do so. Its main use is in desktop boot files.
*ChangeDynamicArea -SpriteSize 32K -RamFsSize 100K
None