Fungsi GetTapeStatus (winbase.h)

Fungsi GetTapeStatus menentukan apakah perangkat pita siap memproses perintah pita.

Sintaks

DWORD GetTapeStatus(
  [in] HANDLE hDevice
);

[in] hDevice

Tangani ke perangkat untuk mendapatkan status perangkat. Handel ini dibuat dengan menggunakan fungsi CreateFile .

Jika perangkat pita siap menerima perintah akses pita yang sesuai tanpa mengembalikan kesalahan, nilai pengembalian NO_ERROR.

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

Kode kesalahan	Deskripsi
ERROR_BEGINNING_OF_MEDIA 1102L	Upaya untuk mengakses data sebelum penanda awal media gagal.
ERROR_BUS_RESET 1111L	Kondisi reset terdeteksi di bus.
ERROR_DEVICE_NOT_PARTITIONED 1107L	Informasi partisi tidak dapat ditemukan ketika pita sedang dimuat.
ERROR_DEVICE_REQUIRES_CLEANING 1165L	Tape drive mampu melaporkan bahwa itu membutuhkan pembersihan, dan melaporkan bahwa itu memang membutuhkan pembersihan.
ERROR_END_OF_MEDIA 1100L	Penanda akhir pita tercapai selama operasi.
ERROR_FILEMARK_DETECTED 1101L	Cap 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	Setmark 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.

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