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.
[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 |
---|---|
|
Upaya untuk mengakses data sebelum penanda awal menengah gagal. |
|
Kondisi reset terdeteksi pada bus. |
|
Informasi partisi tidak dapat ditemukan ketika pita sedang dimuat. |
|
Penanda akhir pita tercapai selama operasi. |
|
Tanda file tercapai selama operasi. |
|
Ukuran blok salah pada pita baru dalam partisi multivolume. |
|
Pita yang ada di kandar telah diganti atau dilepas. |
|
Penanda akhir data tercapai selama operasi. |
|
Tidak ada media di dalam kandar. |
|
Driver pita tidak mendukung fungsi yang diminta. |
|
Pita tidak dapat dipartisi. |
|
Tanda set tercapai selama operasi. |
|
Upaya untuk mengunci mekanisme ejeksi gagal. |
|
Upaya untuk membongkar pita gagal. |
|
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 |