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)

Lihat juga

IOCTL_TAPE_SET_POSITION

TapeMiniSetPosition