TAPE_SET_POSITION
The TAPE_SET_POSITION
structure describes how and where to position the tape.
typedef struct _TAPE_SET_POSITION { // tspos
ULONG
Method;
ULONG
Partition;
ULONG
OffsetLow;
ULONG
OffsetHigh;
} TAPE_SET_POSITION;
Members
Method
Specifies the
type of positioning. This member must be one of the following values:
|
Value |
Description |
|
TAPE_ABSOLUTE_BLOCK |
Moves the
tape to the device-specific block address specified by the OffsetLow
and OffsetHigh members. The Partition member is ignored. |
|
TAPE_LOGICAL_BLOCK |
Moves the
tape to the block address specified by OffsetLow and OffsetHigh
in the partition specified by Partition. |
|
TAPE_REWIND |
Moves the
tape to the beginning of the current partition. The Partition, OffsetLow,
and OffsetHigh members are ignored. |
|
TAPE_SPACE_END_OF_DATA |
Moves the
tape to the end of the data on the partition specified by Partition. |
|
TAPE_SPACE_FILEMARKS |
Moves the
tape forward (or backward) the number of filemarks specified by OffsetLow
and OffsetHigh in the current partition. The Partition member
is ignored. |
|
TAPE_SPACE_RELATIVE_BLOCKS |
Moves the
tape forward (or backward) the number of blocks specified by OffsetLow
and OffsetHigh in the current partition. The Partition member
is ignored. |
|
TAPE_SPACE_SEQUENTIAL_FMKS |
Moves the
tape forward (or backward) to the first occurrence of n filemarks in
the current partition, where n is the number specified by OffsetLow
and OffsetHigh. The Partition parameter is ignored. |
|
TAPE_SPACE_SEQUENTIAL_SMKS |
Moves the
tape forward (or backward) to the first occurrence of n setmarks in
the current partition, where n is the number specified by OffsetLow
and OffsetHigh. The Partition member is ignored. |
|
TAPE_SPACE_SETMARKS |
Moves the
tape forward (or backward) the number of setmarks specified by OffsetLow
and OffsetHigh in the current partition. The Partition member
is ignored. |
Partition
Specifies the
partition to position within. If this member is zero, the current partition is
assumed.
OffsetLow
Specifies the
low-order 32 bits of the block address or count for the position operation
specified by the Method member.
OffsetHigh
Specifies the
high-order 32 bits of the block address or count for the position operation
specified by the Method member. If the high-order 32 bits are not
required, this member should be zero.
Remarks
If the
positioning is relative, a positive offset moves the tape forward (toward the
end of the tape) and a negative offset moves the tape backward (toward the
beginning of the tape).