TAPE_SET_POSITION Struktur (ntddtape.h)
Die TAPE_SET_POSITION Struktur wird in Verbindung mit der IOCTL_TAPE_SET_POSITION Anforderung verwendet, um die aktuelle Position auf dem Band an 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;
Angehörige
Method
Gibt den Typ der auszuführenden Positionierung an. Dieses Element muss einen der folgenden Werte aufweisen:
TAPE_REWIND
Positioniert das Band am Anfang der Partition, die in Partition angegeben ist,, wenn das Medium partitioniert ist, und am Anfang des Mediums, wenn das Medium nicht partitioniert ist. Wenn das Medium nicht partitioniert ist, muss Partition auf Null festgelegt werden. Das Offset-element wird ignoriert.
TAPE_ABSOLUTE_BLOCK
Positioniert das Band an der absoluten Blockadresse, die sich am Offset vom Anfang befindet, der durch Offsetangegeben wird. Der Wert im Partition Member wird ignoriert.
TAPE_LOGICAL_BLOCK
Positioniert das Band an die logische Blockadresse, die durch Offsetangegeben wird, relativ zum Anfang der Partition, die in Partitionangegeben ist. Wenn das Medium nicht partitioniert ist, muss Partition auf Null festgelegt werden.
TAPE_PSEUDO_LOGICAL_BLOCK
Positioniert das Band an die pseudologische Blockadresse, die durch Offsetangegeben wird, relativ zum Anfang der Partition, die in Partitionangegeben ist. Wenn das Medium nicht partitioniert ist, muss Partition null sein.
TAPE_SPACE_END_OF_DATA
Positioniert das Band am Ende der Partition, die in Partitionangegeben ist, oder wenn das Medium nicht partitioniert ist, am Ende des Bandes. Das Offset-element wird ignoriert.
TAPE_SPACE_RELATIVE_BLOCKS
Ab der aktuellen Position positioniert das Band unmittelbar nach der Anzahl der durch Offsetangegebenen Blöcke. Das Partitionselement wird ignoriert.
TAPE_SPACE_FILEMARKS
Ab der aktuellen Position positioniert das Band unmittelbar nach der Anzahl der durch Offsetangegebenen Dateizeichen. Das Partitionselement wird ignoriert.
TAPE_SPACE_SEQUENTIAL_FMKS
Ab der aktuellen Position positioniert das Band unmittelbar nach dem nächsten Vorkommen( falls vorhanden) der Anzahl aufeinander folgender Dateizeichen, 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 Offsetangegebenen Setmarks. Das Partitionselement wird ignoriert.
TAPE_SPACE_SEQUENTIAL_SMKS
Ab der aktuellen Position positioniert das Band unmittelbar nach dem nächsten Vorkommen, falls vorhanden, der Anzahl der aufeinander folgenden Satzzeichen, die durch Offset-angegeben werden. Das Partitionselement wird ignoriert.
Partition
Gibt die Partition an, in der die Position des Bandes festgelegt werden soll. Dieses Element muss einen der folgenden Werte aufweisen:
- NOT_PARTITIONED (oder Null)
- DATA_PARTITION
- DIRECTORY_PARTITION
Wenn das Medium nicht partitioniert ist, ist dieses Element null.
Offset
Gibt einen Offset an, dessen Typ vom Wert in Methodabhängt. Wenn die angegebene Methode das Band an eine Blockadresse positioniert, gibt Offset den Byte-Offset in der angegebenen Partition an. Wenn die angegebene Methode Blöcke, Filemarks oder Setmarks überspringt, gibt Offset- die zu überspringende Zahl an. Wenn Offset- null ist, wird das Band am Anfang der Partition positioniert.
Immediate
Wenn dieser Wert auf TRUE-festgelegt ist, wird angegeben, dass das Zielgerät den Status sofort zurückgeben soll. Wenn dieser Wert auf FALSE-festgelegt ist, wird angegeben, dass das Gerät den Status nach Abschluss des Vorgangs zurückgeben soll.
Bemerkungen
Beachten Sie, dass ein Laufwerk oder ein Band möglicherweise nicht alle Method Werte unterstützt.
Partitionen werden logisch von 1 bis N nummeriert. Eine Partitionsnummer impliziert jedoch keine physische Position auf dem Band. Beispielsweise befindet sich die Partitionsnummer 1 möglicherweise nicht am Anfang des Mediums.
Wenn der Offset eine Reihe von Blöcken, Dateizeichen oder Setmarks angibt, die sich positionieren sollen, führt ein positiver Wert N im Offset dazu, dass die Vorwärtspositionierung über N-Blöcke, Dateizeichen oder Setmarks erfolgt, das Anhalten auf der End-of-Partitions- oder Ende-of-Tape-Seite des Blocks, des Dateizeichens oder des Setmarks angehalten wird. Ein Nullwert im Offset bewirkt keine Änderung der Position. Ein negativer Wert N im Offset bewirkt eine umgekehrte Positionierung, gegenüber dem Anfang der Partition oder des Bandmediums, über N-Blöcke, Dateizeichen oder Setmarks, das Anhalten am Anfang der Partitionsseite eines Blocks, eines Dateizeichens oder eines Setmarks.
Anforderungen
| Anforderung | Wert |
|---|---|
| Header- | ntddtape.h (include Ntddtape.h, Minitape.h) |