Home / Autodocs / trackfile.device
NAME
- TFStopUnitTagList
-
Stop a trackfile.device unit, releasing as much memory possible.
SYNOPSIS
error = TFStopUnitTagList(which_unit, tags)
LONG TFStopUnitTagList(LONG which_unit, CONST struct TagItem *tags);
LONG TFStopUnitTags(LONG which_unit, ...);
D0 D0 A0
LONG TFStopUnitTags(LONG which_unit, ...);
FUNCTION
If a trackfile.device unit is currently operational but no longer needed, it can be shut down. This will release some memory such as used by the unit Process. If a unit is stopped, it can be restarted through the TFStartUnitTagList() function.
INPUTS
- which_unit
-
Which unit to stop. Unit numbers must be >= 0.
- tags
-
Pointer to a list of TagItems; this may be NULL.
TAGS
No tags are currently applicable for the TFStopUnitTagList() function.
RESULT
- error
-
Zero if successful, otherwise an error code is returned.
- TFERROR_UnitNotFound
-
The unit you wanted to stop is not currently known or active.
- ERROR_OBJECT_IN_USE
-
The unit you wanted to stop still has an ADF disk file attached and is busy. You may want to eject the ADF disk image file first through the TFEjectMediaTagList() function.
- TFERROR_Aborted
-
The unit you wanted to shut is already in the process of shutting and has ignored your request to shut down.
SEE ALSO
<exec/errors.h>, <devices/trackdisk.h>, <devices/trackfile.h>, TFEjectMediaTagList(), TFStartUnitTagList(), TFGetUnitData()