h6. [[DOSFS]] h6(. » [[DOSFS SWI Calls|SWI Calls]] h6((. » DOSFS_LayoutStructure h2. DOSFS_LayoutStructure h5. (SWI &44B01) |_<^{width:4em}. Entry | | |<^. R0 |<^. Pointer to [[DOSFS Format Specifier|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 | |_<^{width:4em}. Exit | | |<^. R0 |<^. Preserved | |<^. R1 |<^. Preserved | |<^. R2 |<^. Preserved | |<^. R3 |<^. Preserved | h4. 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). h4. 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. h4. See also * [[DOSFS]] * [[DOSFS_DiscFormat]] * [[FileCore]]