OS_Module 19 (changes)
Showing changes from revision #2 to #3:
Added | Removed | Changed
OS SWI Calls
» OS_Module
» OS_Module 19
OS_ Module 19
(SWI &1E)
| Entry | |
|---|---|
| R0 | 19 (&13) |
| R1 | Module number, or 0 to start |
| R2 | ROM section |
| Exit | |
|---|---|
| R0 | Preserved |
| R1 | Module number of found module +1 |
| R2 | ROM section |
| R3 | Pointer to module name |
| R4 | Status |
| R5 | Chunk number of expansion card module |
Use
The purpose of this call is to enumerate ROM modules.
Notes
This call returns information on one module that is currently in ROM along with its status. The module found is the given number of modules on from start of the given ROM section. If there are insufficient modules in the ROM section then the search continues with the next section; so the fifth module in a four module section would in fact be the first module of the next section. The ROM sections are scanned in order. The values in R0-R2 are the correct ones to use this call to enumerate the next module; hence repeated calls will give a full enumeration of all ROM modules.
The PRM states that when the end of the list an ‘No more modules’ will be returned with error number &107. This is incorrect; error number &108 will be returned. (&107 relates to the module prefix).
OS_Module 20 is provides the same functionality, but in addition returns the version information (in R6).
See also
Social
and
ROOL Store
Buy RISC OS Open merchandise here, including SD cards for Raspberry Pi and more.