Fungsi CreateTapePartition (winbase.h)

Artikel
08/27/2023

Fungsi CreateTapePartition memformat ulang pita.

Sintaks

DWORD CreateTapePartition(
  [in] HANDLE hDevice,
  [in] DWORD  dwPartitionMethod,
  [in] DWORD  dwCount,
  [in] DWORD  dwSize
);

Parameter

[in] hDevice

Tangani ke perangkat tempat partisi baru akan dibuat. Handel ini dibuat dengan menggunakan fungsi CreateFile .

[in] dwPartitionMethod

Jenis partisi yang akan dibuat. Untuk menentukan jenis partisi yang didukung perangkat Anda, lihat dokumentasi untuk perangkat keras Anda. Parameter ini dapat memiliki salah satu nilai berikut.

Nilai	Makna
TAPE_FIXED_PARTITIONS 0L	Mempartisi pita berdasarkan definisi default partisi perangkat. Parameter dwCount dan dwSize diabaikan.
TAPE_INITIATOR_PARTITIONS 2L	Mempartisi pita ke dalam jumlah dan ukuran partisi yang ditentukan oleh dwCount dan dwSize, masing-masing, kecuali untuk partisi terakhir. Ukuran partisi terakhir adalah sisa pita.
TAPE_SELECT_PARTITIONS 1L	Mempartisi pita ke dalam jumlah partisi yang ditentukan oleh dwCount. Parameter dwSize diabaikan. Ukuran partisi ditentukan oleh ukuran partisi default perangkat. Untuk informasi lebih spesifik, lihat dokumentasi untuk perangkat pita Anda.

[in] dwCount

Jumlah partisi yang akan dibuat. Fungsi GetTapeParameters menyediakan jumlah maksimum partisi yang dapat didukung pita.

[in] dwSize

Ukuran setiap partisi, dalam megabyte. Nilai ini diabaikan jika parameter dwPartitionMethodTAPE_SELECT_PARTITIONS.

Nilai kembali

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_END_OF_MEDIA 1100L	Penanda akhir pita tercapai selama operasi.
ERROR_FILEMARK_DETECTED 1101L	Tanda file tercapai selama operasi.
ERROR_SETMARK_DETECTED 1103L	Tanda set tercapai selama operasi.
ERROR_NO_DATA_DETECTED 1104L	Penanda akhir data tercapai selama operasi.
ERROR_PARTITION_FAILURE 1105L	Pita tidak dapat dipartisi.
ERROR_INVALID_BLOCK_LENGTH 1106L	Ukuran blok salah pada pita baru dalam partisi multivolume.
ERROR_DEVICE_NOT_PARTITIONED 1107L	Informasi partisi tidak dapat ditemukan ketika pita sedang dimuat.
ERROR_MEDIA_CHANGED 1110L	Pita yang ada di kandar telah diganti atau dilepas.
ERROR_NO_MEDIA_IN_DRIVE 1112L	Tidak ada media di dalam kandar.
ERROR_NOT_SUPPORTED 50L	Driver pita tidak mendukung fungsi yang diminta.
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

Membuat partisi memformat ulang pita. Semua informasi sebelumnya yang terekam pada rekaman dihancurkan.

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

GetTapeParameters

Bagikan melalui