FileCore_DiscFormat
Programmer's Reference Manuals
» Part 15 – SWI Calls
» FileCore
» FileCore_DiscFormat
FileCore_DiscFormat
(SWI &40547)
| Entry | |
|---|---|
| R0 | Pointer to disc format structure to be filled in |
| R1 | SWI number to call to vet disc format (eg ADFS_VetFormat?) |
| R2 | Parameter in R1 to use when calling vetting SWI |
| R3 | Format specifier |
| Exit | |
|---|---|
| R0 | Preserved |
| R1 | Preserved |
| R2 | Preserved |
| R3 | Preserved |
Use
The purpose of this call is to fill in a disc format structure with parameters for the specified format.
Notes
This call fills in the disc format structure pointed to by R0 with the ‘perfect’ parameters for the specified format, taking no account of the abilities of the available hardware that will have to perform the format. Once filled in, this SWI calls the vetting SWI to check the format structure for achievability on the available hardware.
The vetting SWI may generate an error if the format differs widely from what can be achieved; alternatively it may alter the format structure to the closest match that can be achieved. The vetting SWI then returns to this
SWI, which checks whether the format block – as updated by the vetting SWI – is still an adequate match for the desired format. If it is, this SWI returns to its caller; otherwise it generates an error.
See also
- ADFS_VetFormat?
- Disc Format Block
- FileCore
- Format Specifier