TFGetUnitData

Obtain information about the current state of a trackfile.device unit.

You can retrieve information about the current state of each trackfile.device unit which may be suitable for display in a form comparable to the AmigaDOS "Info" shell command.

Information includes whether or not a disk image file is currently used by the unit, the name of that disk image file, which AmigaDOS file system device name the unit uses (if any), which checksum the disk image file has, and whether this is a bootable disk.

You can retrieve information for individual unit as well as ask for the complete list of currently active units.

The data structure returned by TFGetUnitData() must be released with TFFreeUnitData() when it is no longer needed.

which_unit

Which unit to retrieve information for; this should be a number >= 0. Alternatively, you can retrieve information for all currently active unit by using TFGUD_AllUnits instead.

data

Pointer to a "struct TrackFileUnitData" data structure list or NULL. If NULL is returned, check with dos.library/IoErr() for more information. When no longer needed, release the memory allocated with the TFFreeUnitData() function.

TFGetUnitData() will return a "snapshot" of the current state of the respective units. Each such snapshot represents an independent, complete copy of the unit state information and will need to be released when no longer needed. More active units will require more memory to store the snapshot.

<devices/trackdisk.h>, <devices/trackfile.h>, TFFreeUnitData()