TAPE_SET_POSITION structure

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.

ValueMeaning
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

Minimum supported client

Windows XP [desktop apps only]

Minimum supported server

Windows Server 2003 [desktop apps only]

Header

Winnt.h (include Windows.h)

 

 

Community Additions

ADD
Show: