MM_TAPE_CONTROL

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

handle
The handle of the device received from MM_ReserveIOObject.
function
Set to MM_TAPE_CONTROL.
parameter1
Indicates the operation to perform:0 = quick erase (re-format)1 = security erase (zero out all blocks)2 = create tape partition3 = tension
parameter2
Indicates the number of tape partitions to create (used only if parameter1 = create tape partition).
parameter3
Reserved. Set to zero.
bufferLen
Byte count of buffer array; equals (Parameter 2) * 4.
buffer
Pointer to array of LONGs, where each LONG indicates the size of each tape 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.

NOTE:Partition 0 is always the last partition on the tape and will be the first LONG in this array of type LONG.

returnParameter
Not used.

Return Values

The following table lists return values and descriptions.

0x00000000

MM_OK