TAPE_SET_POSITION Struktur (winnt.h)

Artikel
03/04/2024

Die TAPE_SET_POSITION-Struktur beschreibt, wie und wo das Band positioniert werden soll.

Syntax

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

Member

Method

Art der Positionierung. Dieser Member muss einer der folgenden Werte sein.

Wert	Bedeutung
TAPE_ABSOLUTE_BLOCK 1 L	Verschiebt das Band an die gerätespezifische Blockadresse, die vom Offset-Element angegeben wird. Das Partitionselement wird ignoriert.
TAPE_LOGICAL_BLOCK 2L	Verschiebt das Band an die Blockadresse, die durch Offset in der von Partition angegebenen Partition angegeben wird.
TAPE_REWIND 0L	Verschiebt das Band an den Anfang der aktuellen Partition. Die Elemente Partition und Offset werden ignoriert.
TAPE_SPACE_END_OF_DATA 4L	Verschiebt das Band an das Ende der Daten auf der von Partition angegebenen Partition.
TAPE_SPACE_FILEMARKS 6L	Verschiebt das Band nach vorne (oder rückwärts) die Anzahl von Dateizeichen, die von Offset in der aktuellen Partition angegeben wurden. Das Partitionselement wird ignoriert.
TAPE_SPACE_RELATIVE_BLOCKS 5L	Verschiebt das Band nach vorne (oder rückwärts) die Durch Offset angegebene Anzahl von Blöcken in der aktuellen Partition. Das Partitionselement wird ignoriert.
TAPE_SPACE_SEQUENTIAL_FMKS 7L	Verschiebt das Band vorwärts (oder rückwärts) zum ersten Vorkommen von n-Dateizeichen in der aktuellen Partition, wobei n die durch Offset angegebene Zahl ist. Der Partitionsparameter wird ignoriert.
TAPE_SPACE_SEQUENTIAL_SMKS 9L	Verschiebt das Band vorwärts (oder rückwärts) zum ersten Vorkommen von n Setmarks in der aktuellen Partition, wobei n die durch Offset angegebene Zahl ist. Das Partitionselement wird ignoriert.
TAPE_SPACE_SETMARKS 8L	Verschiebt das Band die Anzahl der durch Offset in der aktuellen Partition angegebenen Setmarkierungen vorwärts (oder rückwärts). Das Partitionselement wird ignoriert.

Partition

Partitionieren, um innerhalb zu positionieren. Wenn dieser Member 0 ist, wird die aktuelle Partition angenommen.

Offset

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

Immediate

Wenn dieser Member TRUE ist, geben Sie zurück, sobald der Vorgang beginnt. Andernfalls kehren Sie nach Abschluss des Vorgangs zurück.

Hinweise

Wenn die Positionierung relativ ist, verschiebt ein positiver Offset das Band nach vorne (gegen Ende des Bandes), und ein negativer Offset verschiebt das Band nach hinten (zum Anfang des Bandes).

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Kopfzeile	winnt.h (Einschließen von Windows.h)

Share via