TAPE_SET_POSITION

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

typedef struct _TAPE_SET_POSITION { 
  DWORD Method; 
  DWORD Partition; 
  LARGE_INTEGER Offset; 
  BOOLEAN Immediate; 
} TAPE_SET_POSITION, *PTAPE_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 Offset member. The Partition member is ignored.
TAPE_LOGICAL_BLOCK	Moves the tape to the block address specified by Offset in the partition specified by Partition.
TAPE_REWIND	Moves the tape to the beginning of the current partition. The Partition and Offset 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 Offset 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 Offset 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 Offset. 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 Offset. The Partition member is ignored.
TAPE_SPACE_SETMARKS	Moves the tape forward (or backward) the number of setmarks specified by Offset 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.

Offset

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

Immediate

Specifies whether to return as soon as the operation begins.

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

  Windows NT/2000: Requires Windows NT 3.1 or later.
  Header: Declared in Winnt.h; include Windows.h.

See Also

Tape Backup Overview, Tape Backup Structures