TFChangeUnitTagList: Change the mode of operation for a trackfile.device unit or for all currently active units.

error = TFChangeUnitTagList(which_unit, tags)

D0 D0 A0

LONG TFChangeUnitTagList(LONG which_unit,

const struct TagItem *tags);

LONG TFChangeUnitTags(LONG which_unit, ...);

How a unit was set up when it was started and when a disk image file was loaded may not be useful for long. For example, a write-protected disk should really be writable, or caching for a unit should be enabled. TFChangeUnitTagList() provides the means to change these parameters, and more.

which_unit: Which specific unit to change, which must be a number >= 0. Alternatively, you can change the global configuration for all units by using TFUNIT_CONTROL.
tags: Pointer to a list of TagItems; this may be NULL.

TF_TagItemFailed (struct TagItem **): If one of the changes you wanted to make is not supported or the change attempt has failed, you can find out which TagItem specifically caused a problem. Its address will be placed in the pointer you placed in the TF_TagItemFailed item's ti_Data member.
TF_WriteProtected (BOOL): You may change whether or not the disk image file which is attached to this unit should be write-enabled or write-protected. This involves, if necessarily, "ejecting" the disk, changing the protection and re-inserting it again. Please note that asking for the medium to be write-enabled may not be possible if the volume on which it resides is write-protected.
TF_MaxCacheMemory (ULONG): How much memory may be used for the shared unit cache can be configured here. This is a setting which affects all units and therefore requires that you specify TFUNIT_CONTROL as the unit number.

The amount of cache memory is given as the maximum number of bytes to allocate and manage for it. A value of 0 will disable the cache.
TF_EnableUnitCache (BOOL): Whether or not a unit should make use of the shared unit cache can controlled for each unit individually. Please note that if the maximum amount of memory the shared unit cache may use is set to 0 then no unit will be able to use the shared cache and enabling it will have no effect.

error: Zero if successful, otherwise an error code is returned.

TFChangeUnitTagList() will stop processing the TagItem list as soon as an error is detected. Some of the TagItems may get processed before further processing is aborted.

NAME

SYNOPSIS

FUNCTION

INPUTS

TAGS

RESULT

NOTES

SEE ALSO