struktur TAPE_SET_POSITION (minitape.h)
Struktur TAPE_SET_POSITION digunakan bersama dengan permintaan IOCTL_TAPE_SET_POSITION untuk memindahkan posisi saat ini pada pita ke partisi dan offset yang ditentukan.
Sintaks
typedef struct _TAPE_SET_POSITION {
ULONG Method;
ULONG Partition;
LARGE_INTEGER Offset;
BOOLEAN Immediate;
} TAPE_SET_POSITION, *PTAPE_SET_POSITION;
Anggota
Method
Menunjukkan jenis posisi yang akan dilakukan. Anggota ini harus memiliki salah satu nilai berikut:
TAPE_REWIND
Memposisikan pita di awal partisi yang ditunjukkan dalam Partisi jika media dipartisi, dan ke awal media jika media tidak dipartisi. Jika media tidak dipartisi, Partisi harus diatur ke nol. Anggota Offset diabaikan.
TAPE_ABSOLUTE_BLOCK
Memposisikan pita pada alamat blok absolut yang terletak di offset dari awal yang ditentukan oleh Offset. Nilai dalam anggota Partisi diabaikan.
TAPE_LOGICAL_BLOCK
Memposisikan pita ke alamat blok logis yang ditentukan oleh Offset, relatif terhadap awal partisi yang ditunjukkan dalam Partisi. Jika media tidak dipartisi, Partisi harus diatur ke nol.
TAPE_PSEUDO_LOGICAL_BLOCK
Memposisikan pita ke alamat blok pseudologis yang ditentukan oleh Offset, relatif terhadap awal partisi yang ditunjukkan dalam Partisi. Jika media tidak dipartisi, Partisi harus nol.
TAPE_SPACE_END_OF_DATA
Memposisikan pita di akhir partisi yang ditunjukkan di Partisi, atau jika media tidak dipartisi, di akhir pita. Anggota Offset diabaikan.
TAPE_SPACE_RELATIVE_BLOCKS
Mulai dari posisi saat ini, posisi pita segera setelah jumlah blok yang ditentukan oleh Offset. Anggota Partisi diabaikan.
TAPE_SPACE_FILEMARKS
Mulai dari posisi saat ini, posisi pita segera setelah jumlah marka file yang ditentukan oleh Offset. Anggota Partisi diabaikan.
TAPE_SPACE_SEQUENTIAL_FMKS
Mulai dari posisi saat ini, memposisikan pita segera setelah kemunculan berikutnya, jika ada, dari jumlah marka file berturut-turut yang ditentukan oleh Offset. Anggota Partisi diabaikan.
TAPE_SPACE_SETMARKS
Mulai dari posisi saat ini, memposisikan pita segera setelah jumlah setmark yang ditentukan oleh Offset. Anggota Partisi diabaikan.
TAPE_SPACE_SEQUENTIAL_SMKS
Mulai dari posisi saat ini, memposisikan pita segera setelah kemunculan berikutnya, jika ada, dari jumlah setmark berturut-turut yang ditentukan oleh Offset. Anggota Partisi diabaikan.
Partition
Menunjukkan partisi untuk mengatur posisi pita. Anggota ini harus memiliki salah satu nilai berikut:
- NOT_PARTITIONED (atau nol)
- DATA_PARTITION
- DIRECTORY_PARTITION
Jika media tidak dipartisi, anggota ini nol.
Offset
Menentukan offset yang jenisnya bergantung pada nilai dalam Metode. Jika metode yang ditentukan memposisikan pita ke alamat blok, Offset menentukan offset byte ke dalam partisi yang ditentukan. Jika metode yang ditentukan adalah melewati blok, marka file, atau setmark, Offset menentukan angka yang akan dilewati. Jika Offset adalah nol, pita diposisikan di awal partisi.
Immediate
Saat diatur ke TRUE, menunjukkan bahwa perangkat target harus segera mengembalikan status. Saat diatur ke FALSE, menunjukkan bahwa perangkat harus mengembalikan status setelah operasi selesai.
Keterangan
Perhatikan bahwa drive atau pita mungkin tidak mendukung semua nilai Metode .
Partisi diberi nomor logis dari 1 hingga N. Namun, nomor partisi tidak menyiratkan posisi fisik pada pita. Misalnya, partisi nomor satu mungkin tidak berada di awal media.
Ketika offset menentukan sejumlah blok, marka file, atau setmark yang akan diposisikan, nilai positif N dalam offset menyebabkan penempatan penerusan atas blok N, tanda file, atau tanda set, berhenti di sisi end-of-partition atau end-of-tape blok, marka file, atau setmark. Nilai nol dalam offset tidak menyebabkan perubahan posisi. Nilai negatif N dalam offset menyebabkan penempatan terbalik, menuju awal partisi atau media pita, melalui blok N, marka file, atau tanda set, berhenti di sisi awal partisi blok, tanda file, atau setmark.
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Header | minitape.h (termasuk Ntddtape.h, Minitape.h) |