h6. [[FileCore]] h6(. » [[FileCore SWI Calls|SWI Calls]] h6((. » FileCore_DiscFormat h2. FileCore_DiscFormat h5. (SWI &40547) |_<^{width:4em}. Entry | | |<^. R0 |<^. Pointer to [[Disc Format Block|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|Format specifier]] | |_<^{width:4em}. Exit | | |<^. R0 |<^. Preserved | |<^. R1 |<^. Preserved | |<^. R2 |<^. Preserved | |<^. R3 |<^. Preserved | h4. Use The purpose of this call is to fill in a disc format structure with parameters for the specified format. h4. 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. h4. See also * [[ADFS_VetFormat]] * [[Disc Format Block]] * [[FileCore]] * [[Format Specifier]]