Edit

TAPE_SET_POSITION structure (winnt.h)

  • Article

The TAPE_SET_POSITION structure describes how and where to position the tape.

Syntax

typedef struct _TAPE_SET_POSITION {
  DWORD         Method;
  DWORD         Partition;
  LARGE_INTEGER Offset;
  BOOLEAN       Immediate;
} TAPE_SET_POSITION, *PTAPE_SET_POSITION;

Members

Method

Type of positioning. This member must be one of the following values.

Value Meaning
TAPE_ABSOLUTE_BLOCK
1L
 Moves the tape to the device-specific block address specified by the Offset member. The Partition member is ignored.
TAPE_LOGICAL_BLOCK
2L
 Moves the tape to the block address specified by Offset in the partition specified by Partition.
TAPE_REWIND
0L
 Moves the tape to the beginning of the current partition. The Partition and Offset members are ignored.
TAPE_SPACE_END_OF_DATA
4L
 Moves the tape to the end of the data on the partition specified by Partition.
TAPE_SPACE_FILEMARKS
6L
 Moves the tape forward (or backward) the number of filemarks specified by Offset in the current partition. The Partition member is ignored.
TAPE_SPACE_RELATIVE_BLOCKS
5L
 Moves the tape forward (or backward) the number of blocks specified by Offset in the current partition. The Partition member is ignored.
TAPE_SPACE_SEQUENTIAL_FMKS
7L
 Moves the tape forward (or backward) to the first occurrence of n filemarks in the current partition, where n is the number specified by Offset. The Partition parameter is ignored.
TAPE_SPACE_SEQUENTIAL_SMKS
9L
 Moves the tape forward (or backward) to the first occurrence of n setmarks in the current partition, where n is the number specified by Offset. The Partition member is ignored.
TAPE_SPACE_SETMARKS
8L
 Moves the tape forward (or backward) the number of setmarks specified by Offset in the current partition. The Partition member is ignored.

Partition

Partition to position within. If this member is zero, the current partition is assumed.

Offset

Block address or count for the position operation specified by the Method member.

Immediate

If this member is TRUE, return as soon as the operation begins. Otherwise, return after the operation has completed.

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

Requirements

Requirement Value
Minimum supported client Windows XP [desktop apps only]
Minimum supported server Windows Server 2003 [desktop apps only]
Header winnt.h (include Windows.h)