Home / Autodocs / trackfile.device
NAME
- TFInsertMediaTagList
-
Insert a floppy disk into a trackfile.device unit by loading a floppy disk image file.
SYNOPSIS
error = TFInsertMediaTagList(which_unit, tags)
LONG TFInsertMediaTagList(LONG which_unit,
LONG TFInsertMediaTags(LONG which_unit, ...);
D0 D0 A0
CONST struct TagItem *tags);
FUNCTION
After a trackfile.device unit has been started, or its "floppy disk" has been ejected, a floppy disk image file may be "inserted" into it. You need to specify either the name of the floppy disk image file in question or you may provide an already opened file.
INPUTS
- which_unit
-
Which unit to insert the disk image file into. Unit numbers must be >= 0.
- tags
-
Pointer to a list of TagItems; this may be NULL.
TAGS
- TF_ImageFileName (STRPTR)
-
Name of the floppy disk image file to "insert". This may include the full path to the file or may be just the file name relative to the current directory of the Process calling this function. Defaults to NULL.
Please note that the TF_ImageFileName TagItem will be ignored if you use the TF_ImageFileHandle with a non-NULL file handle value.
- TF_ImageFileHandle (BPTR)
-
Use an already open file instead of opening a named file. Defaults to NULL.
Please note that the TF_ImageFileName TagItem will be ignored if you use the TF_ImageFileHandle with a non-NULL file handle value.
- TF_WriteProtected (BOOL)
-
You may request that the disk image file to be used should be write-enabled. Defaults to FALSE.
- TF_EnableUnitCache (BOOL)
-
If the shared read cache for all trackfile.device units was enabled, you may request that the unit for which you are now loading a disk image file should make use of that cache. Defaults to FALSE.
- TF_PrefillUnitCache (BOOL)
-
If you enabled the use of the shared unit cache (and that cache is active) you may want the entire disk image file you are loading disk to be cached. This involves reading the file and storing its contents in the cache first, though. Defaults to FALSE.
RESULT
- error
-
Zero if successful, otherwise an error code is returned.
- TFERROR_Denied
-
Only a Process may call the TFInsertMediaTagList() function, never a Task.
- TFERROR_UnitNotFound
-
The unit you requested is either not known or not currently active.
- TFERROR_AlreadyInUse
-
The unit you wanted to insert the disk image file into is already using a disk image.
- TFERROR_InvalidFile
-
The disk image file handle you provided is unusable. Check with dos.library/IoErr() for more information.
- TFERROR_NoFileGiven
-
You need to provide either the TF_ImageFileName or TF_ImageFileHandle tags to indicate the disk image file to be used.
- TFERROR_InvalidFileSize
-
The disk image file you provided does not match the supported 880 KByte or 1760 KByte disk image file types.
- TFERROR_DuplicateVolume
-
There is already is a disk mounted which shares the same volume name and volume creation signature with the disk image file you want to insert. trackfile.device refuses to use it because it would likely cause an AmigaDOS crash.
- TFERROR_DuplicateDisk
-
You enabled the disk checksumming when you started this unit, and there is currently a disk inserted in one of the other trackfile.device units which exactly matches the disk checksum of the disk image file you wanted to insert.
- TFERROR_OutOfMemory
-
Memory could not be allocated.
SEE ALSO
<exec/errors.h>, <devices/trackdisk.h>, <devices/trackfile.h>, <dos/dos.h> TFEjectMediaTagList(), TFStartUnitTagList(), TFGetUnitData()