Fungsi SetTapePosition (winbase.h)
Fungsi SetTapePosition mengatur posisi pita pada perangkat yang ditentukan.
Sintaks
DWORD SetTapePosition(
[in] HANDLE hDevice,
[in] DWORD dwPositionMethod,
[in] DWORD dwPartition,
[in] DWORD dwOffsetLow,
[in] DWORD dwOffsetHigh,
[in] BOOL bImmediate
);
Parameter
[in] hDevice
Tangani ke perangkat untuk mengatur posisi pita. Handel ini dibuat dengan menggunakan fungsi CreateFile .
[in] dwPositionMethod
Jenis posisi yang akan dilakukan. Parameter ini harus menjadi salah satu nilai berikut.
[in] dwPartition
Partisi untuk posisi di dalam. Jika dwPartition adalah nol, partisi saat ini digunakan. Partisi diberi nomor logis dari 1 hingga n, di mana 1 adalah partisi pertama pada pita dan n adalah yang terakhir.
[in] dwOffsetLow
Bit berurutan rendah dari alamat blok atau hitungan untuk operasi posisi yang ditentukan oleh parameter dwPositionMethod .
[in] dwOffsetHigh
Bit urutan tinggi dari alamat blok atau hitungan untuk operasi posisi yang ditentukan oleh parameter dwPositionMethod . Jika bit berurutan tinggi tidak diperlukan, parameter ini harus nol.
[in] bImmediate
Menunjukkan apakah akan kembali segera setelah operasi pemindahan dimulai. Jika parameter ini TRUE, fungsi akan segera ditampilkan; jika FALSE, fungsi tidak kembali sampai operasi pemindahan selesai.
Nilai kembali
Jika fungsi berhasil, nilai yang dikembalikan adalah NO_ERROR.
Jika fungsi gagal, fungsi dapat mengembalikan salah satu kode kesalahan berikut.
Kesalahan | Deskripsi |
---|---|
|
Upaya untuk mengakses data sebelum penanda awal menengah gagal. |
|
Kondisi reset terdeteksi pada bus. |
|
Informasi partisi tidak dapat ditemukan ketika pita sedang dimuat. |
|
Penanda akhir pita tercapai selama operasi. |
|
Tanda file tercapai selama operasi. |
|
Ukuran blok salah pada pita baru dalam partisi multivolume. |
|
Pita yang ada di kandar telah diganti atau dilepas. |
|
Penanda akhir data tercapai selama operasi. |
|
Tidak ada media di dalam kandar. |
|
Driver pita tidak mendukung fungsi yang diminta. |
|
Pita tidak dapat dipartisi. |
|
Tanda set tercapai selama operasi. |
|
Upaya untuk mengunci mekanisme ejeksi gagal. |
|
Upaya untuk membongkar pita gagal. |
|
Media dilindungi terhadap penulisan. |
Keterangan
Jika offset yang ditentukan oleh dwOffsetLow dan dwOffsetHigh menentukan jumlah blok, marka file, atau setmark yang akan dipindahkan, offset positif memindahkan pita maju ke akhir blok terakhir, marka file, atau setmark. Offset negatif memindahkan pita mundur ke awal blok terakhir, marka file, atau tanda set. Jika offset adalah nol, pita tidak bergerak.
Untuk mendapatkan informasi tentang status, kemampuan, dan kapasitas drive dan media pita, panggil fungsi GetTapeParameters .
Persyaratan
Persyaratan | Nilai |
---|---|
Klien minimum yang didukung | Windows XP [hanya aplikasi desktop] |
Server minimum yang didukung | Windows Server 2003 [hanya aplikasi desktop] |
Target Platform | Windows |
Header | winbase.h (termasuk Windows.h) |
Pustaka | Kernel32.lib |
DLL | Kernel32.dll |
Lihat juga
Saran dan Komentar
https://aka.ms/ContentUserFeedback.
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat:Kirim dan lihat umpan balik untuk