TAPE_SET_POSITION-Struktur (ntddtape.h)

  • Artikel

Die TAPE_SET_POSITION-Struktur wird in Verbindung mit der IOCTL_TAPE_SET_POSITION-Anforderung verwendet, um die aktuelle Position auf dem Band in die angegebene Partition und den angegebenen Offset zu verschieben.

Syntax

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

Member

Method

Gibt den Typ der auszuführenden Positionierung an. Dieser Member muss über einen der folgenden Werte verfügen:

TAPE_REWIND

Positioniert das Band am Anfang der Partition, die unter Partition angegeben ist, wenn das Medium partitioniert ist, und am Anfang des Mediums, wenn das Medium nicht partitioniert ist. Wenn die Medien nicht partitioniert sind, muss Partition auf 0 festgelegt werden. Das Offsetelement wird ignoriert.

TAPE_ABSOLUTE_BLOCK

Positioniert das Band an der absoluten Blockadresse, die sich am Offset von dem durch Offset angegebenen Anfang befindet. Der Wert im Partitionsmember wird ignoriert.

TAPE_LOGICAL_BLOCK

Positioniert das Band an der durch Offset angegebenen logischen Blockadresse relativ zum Anfang der Partition, die in Partition angegeben ist. Wenn die Medien nicht partitioniert sind, muss Partition auf 0 festgelegt werden.

TAPE_PSEUDO_LOGICAL_BLOCK

Positioniert das Band an der pseudologischen Blockadresse, die von Offset angegeben wird, relativ zum Anfang der Partition, die in Partition angegeben ist. Wenn das Medium nicht partitioniert ist, muss die Partition auf 0 lauten.

TAPE_SPACE_END_OF_DATA

Positioniert das Band am Ende der Partition, die unter Partition angegeben ist, oder wenn das Medium nicht partitioniert ist, am Ende des Bandes. Das Offsetelement wird ignoriert.

TAPE_SPACE_RELATIVE_BLOCKS

Ab der aktuellen Position positioniert das Band direkt nach der anzahl der Blöcke, die durch Offset angegeben sind. Das Partitionselement wird ignoriert.

TAPE_SPACE_FILEMARKS

Ab der aktuellen Position positioniert das Band unmittelbar nach der Anzahl von Dateimarkierungen, die durch Offset angegeben werden. Das Partitionselement wird ignoriert.

TAPE_SPACE_SEQUENTIAL_FMKS

Ab der aktuellen Position positioniert das Band unmittelbar nach dem nächsten Vorkommen der anzahl aufeinanderfolgender Dateimarkierungen, die durch Offset angegeben werden. Das Partitionselement wird ignoriert.

TAPE_SPACE_SETMARKS

Ab der aktuellen Position positioniert das Band unmittelbar nach der Anzahl der durch Offset angegebenen Setmarkierungen. Das Partitionselement wird ignoriert.

TAPE_SPACE_SEQUENTIAL_SMKS

Ab der aktuellen Position positioniert das Band unmittelbar nach dem nächsten Vorkommen der anzahl aufeinanderfolgender Setmarkierungen, die durch Offset angegeben werden. Das Partitionselement wird ignoriert.

Partition

Gibt die Partition an, in der die Position des Bandes festgelegt werden soll. Dieser Member muss über einen der folgenden Werte verfügen:

NOT_PARTITIONED (oder null)
DATA_PARTITION
DIRECTORY_PARTITION

Wenn die Medien nicht partitioniert sind, ist dieser Member 0.

Offset

Gibt einen Offset an, dessen Typ vom Wert in Method abhängt. Wenn die angegebene Methode das Band an einer Blockadresse positioniert, gibt Offset den Byteoffset in der angegebenen Partition an. Wenn die angegebene Methode Blöcke, Dateizeichen oder Setmarkierungen überspringen soll, gibt Offset die zu überspringende Zahl an. Wenn Offset 0 ist, wird das Band am Anfang der Partition positioniert.

Immediate

Gibt bei Festlegung auf TRUE an, dass das Zielgerät sofort status zurückgeben soll. Gibt bei Festlegung auf FALSE an, dass das Gerät nach Abschluss des Vorgangs status zurückgeben soll.

Hinweise

Beachten Sie, dass ein Laufwerk oder band möglicherweise nicht alle Methodenwerte unterstützt.

Partitionen werden logisch von 1 bis N nummeriert. Eine Partitionsnummer impliziert jedoch keine physische Position auf dem Band. Partition Nummer 1 befindet sich beispielsweise möglicherweise nicht am Anfang des Mediums.

Wenn der Offset eine Anzahl von Blöcken, Dateimarkierungen oder Setmarkierungen angibt, über die positioniert werden sollen, bewirkt ein positiver Wert N im Offset eine Vorwärtspositionierung über N-Blöcke, Dateimarkierungen oder Setmarkierungen, die am Ende der Partition oder am Ende des Bandes des Blocks, der Dateimarke oder des Setmarks angehalten werden. Ein Nullwert im Offset bewirkt keine Positionsänderung. Ein negativer Wert N im Offset bewirkt eine umgekehrte Positionierung am Anfang der Partition oder des Bandmediums über N-Blöcke, Dateimarkierungen oder Setmarkierungen, die am Anfang der Partitionsseite eines Blocks, einer Dateimarke oder eines Setmarks angehalten werden.

Anforderungen

Anforderung Wert
Header ntddtape.h (include Ntddtape.h, Minitape.h)

Weitere Informationen

IOCTL_TAPE_SET_POSITION

TapeMiniSetPosition