Bagikan melalui


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