TD_FORMAT

format a track on a disk.

These commands are used to write data to a track that either has not yet been formatted or has had a hard error on a standard write command. TD_FORMAT completely ignores all data currently on a track and does not check for disk change before performing the command. The io_Data field must point to at least one track worth of data. The io_Offset field must be track aligned, and the io_Length field must be in units of track length (that is, TD_SECTOR * NUMSEC).

The device will format the requested tracks, filling each sector with the contents of the buffer pointed to by io_Data. You should do a read pass to verify the data.

io_Device

preset by the call to OpenDevice()

io_Unit

preset by the call to OpenDevice()

io_Command

TD_FORMAT

io_Flags

0

io_Data

points to a buffer containing the data to write to the track, must be at least as large as io_Length.

io_Length

number of bytes to format, must be a multiple of (TD_SECTOR * NUMSEC).

io_Offset

byte offset from the start of the disk for the track to format, must be a multiple of (TD_SECTOR * NUMSEC).

io_Error

0 for success, or an error code as defined in <devices/trackdisk.h> or <exec/errors.h>

The trackdisk.device TD_FORMAT documentation references the TD_SECTOR and NUMSEC constants. In context, NUMSEC must be either 11 for a double density floppy disk or 22 for a high density floppy disk. TD_SECTOR must always be 512.

CMD_WRITE