ns-winnt-tape_set_position.md

UID	title	description	helpviewer_keywords	old-location	tech.root	ms.assetid	ms.date	ms.keywords	req.header	req.include-header	req.target-type	req.target-min-winverclnt	req.target-min-winversvr	req.kmdf-ver	req.umdf-ver	req.ddi-compliance	req.unicode-ansi	req.idl	req.max-support	req.namespace	req.assembly	req.type-library	req.lib	req.dll	req.irql	targetos	req.typenames	req.redist	ms.custom	f1_keywords	dev_langs	topic_type	api_type	api_location	api_name
NS:winnt._TAPE_SET_POSITION	TAPE_SET_POSITION (winnt.h)	Describes how and where to position the tape.	*PTAPE_SET_POSITION PTAPE_SET_POSITION PTAPE_SET_POSITION structure pointer [Backup] TAPE_ABSOLUTE_BLOCK TAPE_LOGICAL_BLOCK TAPE_REWIND TAPE_SET_POSITION TAPE_SET_POSITION structure [Backup] TAPE_SPACE_END_OF_DATA TAPE_SPACE_FILEMARKS TAPE_SPACE_RELATIVE_BLOCKS TAPE_SPACE_SEQUENTIAL_FMKS TAPE_SPACE_SEQUENTIAL_SMKS TAPE_SPACE_SETMARKS _TAPE_SET_POSITION _win32_tape_set_position_str backup.tape_set_position_str winnt/PTAPE_SET_POSITION winnt/TAPE_SET_POSITION	backup\tape_set_position_str.htm	Backup	ee5e3f0f-b3dd-49a7-889d-d7b96107dc45	12/05/2018	*PTAPE_SET_POSITION, PTAPE_SET_POSITION, PTAPE_SET_POSITION structure pointer [Backup], TAPE_ABSOLUTE_BLOCK, TAPE_LOGICAL_BLOCK, TAPE_REWIND, TAPE_SET_POSITION, TAPE_SET_POSITION structure [Backup], TAPE_SPACE_END_OF_DATA, TAPE_SPACE_FILEMARKS, TAPE_SPACE_RELATIVE_BLOCKS, TAPE_SPACE_SEQUENTIAL_FMKS, TAPE_SPACE_SEQUENTIAL_SMKS, TAPE_SPACE_SETMARKS, _TAPE_SET_POSITION, _win32_tape_set_position_str, backup.tape_set_position_str, winnt/PTAPE_SET_POSITION, winnt/TAPE_SET_POSITION	winnt.h	Windows.h	Windows	Windows XP [desktop apps only]	Windows Server 2003 [desktop apps only]													Windows	TAPE_SET_POSITION, *PTAPE_SET_POSITION		19H1	_TAPE_SET_POSITION winnt/_TAPE_SET_POSITION PTAPE_SET_POSITION winnt/PTAPE_SET_POSITION TAPE_SET_POSITION winnt/TAPE_SET_POSITION	c++	APIRef kbSyntax	HeaderDef	Winnt.h	TAPE_SET_POSITION

TAPE_SET_POSITION structure

-description

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

-struct-fields

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

-field Partition

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

-field Offset

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

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