Fungsi WriteTapemark (winbase.h)

Artikel
08/27/2023

Fungsi WriteTapemark menulis sejumlah marka file, setmark, marka file pendek, atau marka file panjang tertentu ke perangkat pita. Tapemark ini membagi partisi pita menjadi area yang lebih kecil.

Sintaks

DWORD WriteTapemark(
  [in] HANDLE hDevice,
  [in] DWORD  dwTapemarkType,
  [in] DWORD  dwTapemarkCount,
  [in] BOOL   bImmediate
);

Parameter

[in] hDevice

Tangani ke perangkat untuk menulis tapemark. Handel ini dibuat dengan menggunakan fungsi CreateFile .

[in] dwTapemarkType

Jenis tapemark yang akan ditulis. Parameter ini bisa menjadi salah satu nilai berikut.

Nilai	Makna
TAPE_FILEMARKS 1L	Menulis jumlah marka file yang ditentukan oleh parameter dwTapemarkCount .
TAPE_LONG_FILEMARKS 3L	Menulis jumlah tanda file panjang yang ditentukan oleh dwTapemarkCount.
TAPE_SETMARKS 0L	Menulis jumlah setmark yang ditentukan oleh dwTapemarkCount.
TAPE_SHORT_FILEMARKS 2L	Menulis jumlah marka file pendek yang ditentukan oleh dwTapemarkCount.

[in] dwTapemarkCount

Jumlah tapemark yang akan ditulis.

[in] bImmediate

Jika parameter ini TRUE, fungsi akan segera kembali; jika FALSE, fungsi tidak kembali sampai operasi selesai.

Nilai kembali

Jika fungsi berhasil, nilai yang dikembalikan 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 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_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.

Keterangan

Marka file, setmark, marka file pendek, dan marka file panjang adalah elemen rekaman khusus yang menunjukkan organisasi linear pita. Tidak satu pun dari tanda ini berisi data pengguna. Tanda file adalah tanda yang paling umum; setmark menyediakan hierarki yang tidak tersedia dengan marka file.

Tanda file pendek berisi celah penghapusan singkat yang tidak dapat ditimpa kecuali operasi tulis dilakukan dari awal partisi atau dari tanda file panjang sebelumnya.

Tanda file panjang berisi celah penghapusan panjang yang memungkinkan aplikasi untuk memposisikan pita di awal marka file dan menimpa marka file dan menghapus celah.

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

CreateFile

Bagikan melalui