Home / Autodocs / trackfile.device
NAME
TD_RAWREAD/ETD_RAWREAD - read raw data from the disk.
FUNCTION
These commands will produce a track of raw MFM-encoded data from the disk image file data as if it had been read from an Amiga floppy disk drive. This has no real practical use beyond experimentation, testing and quality assurance work.
The MFM-encoded data follows the specifications of the Amiga 1.0 disk format, as described in the 3rd edition "Amiga ROM Kernel Reference Manual: Devices", Appendix C.
The MFM-encoded data follows the specifications of the Amiga 1.0 disk format, as described in the 3rd edition "Amiga ROM Kernel Reference Manual: Devices", Appendix C.
INPUTS
- io_Device
-
preset by the call to OpenDevice()
- io_Unit
-
preset by the call to OpenDevice()
- io_Command
-
TD_RAWREAD or ETD_RAWREAD.
- io_Flags
-
The IOTDB_INDEXSYNC and/or IOTDB_WORDSYNC bits may be set.
- io_Length
-
Length of buffer in bytes, with a maximum of 32768 bytes.
- io_Data
-
Pointer to CHIP memory buffer where raw track data is to be deposited.
- io_Offset
-
The number of the track to read in.
- iotd_Count
-
(ETD_RAWREAD only) maximum allowable change counter value.
RESULT
- io_Error
-
0 for success, or an error code as defined in <devices/trackdisk.h>
NOTES
The track buffer provided MUST be in CHIP memory.
Even if successful, these commands will not update the io_Actual field to reflect the amount of data read.
Even if successful, these commands will not update the io_Actual field to reflect the amount of data read.
SEE ALSO
trackdisk.device/TD_RAWREAD, trackdisk.device/TD_RAWWRITE