Tape Control (0x0001)
Provides additional operations to manage tapes. Use
various combinations of parameters to create tape partitions, retention,
and perform two kinds of erase partition operations.
Parameters
- function
- 0x0001 – tape operation request.
- parameter0
- Flag specifying the type of erase to perform:0 = quick
erase (re-format)1 = security erase (zero out all blocks)2 = create
partition3 = retension
- parameter1
- Indicates the number of partitions to create.
- parameter2
- Not used.
- bufferLength
- Byte count of buffer array; equals (parameter1 * 4).
- buffer
- Pointer to array of LONGs, where each LONG indicates
the size of each partition in megabytes. A -1 in an array location
indicates the tape partition should take the remainder of the tape.
The last partition should always have a -1.
Return Values
The following table lists return values and descriptions.
Remarks
Both erase functions take place from the current position
to the end of the partition. The erase functions do not imply a
rewind of tape media. At the end of the retension operation, the
current partition is undefined. Select another partition [see Select Partition (0x002C)] before continuing.