Fungsi SetTapeParameters (winbase.h)

Fungsi SetTapeParameters menentukan ukuran blok pita atau mengonfigurasi perangkat pita.

Sintaks

DWORD SetTapeParameters(
  [in] HANDLE hDevice,
  [in] DWORD  dwOperation,
  [in] LPVOID lpTapeInformation
);

Parameter

[in] hDevice

Tangani ke perangkat untuk mengatur informasi konfigurasi. Handel ini dibuat dengan menggunakan fungsi CreateFile .

[in] dwOperation

Jenis informasi yang akan diatur. Parameter ini harus menjadi salah satu nilai berikut.

Nilai	Makna
SET_TAPE_DRIVE_INFORMATION 1L	Mengatur informasi khusus perangkat yang ditentukan oleh lpTapeInformation.
SET_TAPE_MEDIA_INFORMATION 0L	Mengatur informasi khusus pita yang ditentukan oleh parameter lpTapeInformation .

[in] lpTapeInformation

Penunjuk ke struktur yang berisi informasi yang akan diatur. Jika parameter dwOperation SET_TAPE_MEDIA_INFORMATION, lpTapeInformation menunjuk ke struktur TAPE_SET_MEDIA_PARAMETERS .

Jika dwOperation SET_TAPE_DRIVE_INFORMATION, lpTapeInformation menunjuk ke struktur TAPE_SET_DRIVE_PARAMETERS .

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.

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

GetTapeParameters

TAPE_SET_DRIVE_PARAMETERS

TAPE_SET_MEDIA_PARAMETERS