Fungsi PrepareTape (winbase.h)

Artikel
08/27/2023

Fungsi PrepareTape menyiapkan pita yang akan diakses atau dihapus.

Sintaks

DWORD PrepareTape(
  [in] HANDLE hDevice,
  [in] DWORD  dwOperation,
  [in] BOOL   bImmediate
);

Parameter

[in] hDevice

Tangani ke perangkat yang menyiapkan pita. Handel ini dibuat dengan menggunakan fungsi CreateFile .

[in] dwOperation

Persiapan perangkat pita. Parameter ini bisa menjadi salah satu nilai berikut.

Nilai	Makna
TAPE_FORMAT 5L	Melakukan format kaset tingkat rendah. Saat ini, hanya perangkat QIC117 yang mendukung fitur ini.
TAPE_LOAD 0L	Memuat pita dan memindahkan pita ke awal.
TAPE_LOCK 3L	Mengunci mekanisme lonjakan pita sehingga pita tidak dikeluarkan secara tidak sengaja.
TAPE_TENSION 2L	Menyesuaikan ketegangan dengan memindahkan pita ke akhir pita dan kembali ke awal. Opsi ini tidak didukung oleh semua perangkat. Nilai ini diabaikan jika tidak didukung.
TAPE_UNLOAD 1L	Memindahkan pita ke awal untuk dihapus dari perangkat. Setelah operasi bongkar berhasil, perangkat mengembalikan kesalahan ke aplikasi yang mencoba mengakses pita, hingga pita dimuat lagi.
TAPE_UNLOCK 4L	Membuka kunci mekanisme lonjakan pita.

[in] bImmediate

Jika parameter ini TRUE, fungsi akan segera ditampilkan. Jika FALSE, fungsi tidak akan kembali hingga operasi selesai.

Mengembalikan nilai

Jika fungsi berhasil, nilai yang dikembalikan adalah NO_ERROR.

Jika fungsi gagal, fungsi dapat mengembalikan salah satu kode kesalahan berikut.

Kesalahan	Deskripsi
ERROR_BEGINNING_OF_MEDIA 1102L	Upaya untuk mengakses data sebelum penanda awal menengah gagal.
ERROR_BUS_RESET 1111L	Kondisi reset terdeteksi pada bus.
ERROR_DEVICE_NOT_PARTITIONED 1107L	Informasi partisi tidak dapat ditemukan ketika pita sedang dimuat.
ERROR_END_OF_MEDIA 1100L	Penanda akhir pita tercapai selama operasi.
ERROR_FILEMARK_DETECTED 1101L	Tanda file tercapai selama operasi.
ERROR_INVALID_BLOCK_LENGTH 1106L	Ukuran blok salah pada pita baru dalam partisi multivolume.
ERROR_MEDIA_CHANGED 1110L	Pita yang ada di kandar telah diganti atau dilepas.
ERROR_NO_DATA_DETECTED 1104L	Penanda akhir data tercapai selama operasi.
ERROR_NO_MEDIA_IN_DRIVE 1112L	Tidak ada media di dalam kandar.
ERROR_NOT_SUPPORTED 50L	Driver pita tidak mendukung fungsi yang diminta.
ERROR_PARTITION_FAILURE 1105L	Pita tidak dapat dipartisi.
ERROR_SETMARK_DETECTED 1103L	Tanda set tercapai selama operasi.
ERROR_UNABLE_TO_LOCK_MEDIA 1108L	Upaya untuk mengunci mekanisme ejeksi gagal.
ERROR_UNABLE_TO_UNLOAD_MEDIA 1109L	Upaya untuk membongkar pita gagal.
ERROR_WRITE_PROTECT 19L	Media dilindungi terhadap penulisan.

Keterangan

Beberapa perangkat pita tidak mendukung operasi pita tertentu. Lihat dokumentasi perangkat pita Anda dan gunakan fungsi GetTapeParameters untuk menentukan kemampuan perangkat pita Anda.

Persyaratan


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

CreateFile

GetTapeParameters

Bagikan melalui