Prev Next

TAPE_SET_POSITION info  Overview  Group

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).