Bagikan melalui

Fungsi WriteTapemark (winbase.h)

  • Artikel

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