DOSFS_LayoutStructure (changes)
Showing changes from revision #0 to #1:
Added | Removed | Changed
DOSFS
» SWI Calls
» DOSFS_LayoutStructure
DOSFS_LayoutStructure
(SWI &44B01)
| Entry | |
|---|---|
| R0 | Pointer to Structure specifier |
| R1 | Pointer to bad block list. This list is terminated by a value of -1 |
| R2 | Pointer to disc name. This is terminated by a value of null |
| R3 | Image file handle |
| Exit | |
|---|---|
| R0 | Preserved |
| R1 | Preserved |
| R2 | Preserved |
| R3 | Preserved |
Use
The purpose of this call is to lay out in the specified image, all necessary structures to have a valid and empty disc.
It can be used:
- to layout a structure on a blank, formatted disc (in which case the specified image should be the whole disc image)
- to layout a partition in a file on a disc that has already been formatted (for example for the PC emulator).
Notes
If the given image format has no option to store a disc name then this parameter should
be ignored.
The bad block list should be presented as an array of bad block addresses. Each address
is four bytes long. The array is terminated by a –1 entry.
It is assumed that R0 gives enough information for the format – it may be that R0
contains many bit fields or points to a block of information – the choice is up to the
image filing system module.
See also
Social
Follow us on
and
and
ROOL Store
Buy RISC OS Open merchandise here, including SD cards for Raspberry Pi and more.