Fungsi GetTapeParameters (winbase.h)

Artikel
03/03/2024

Fungsi GetTapeParameters mengambil informasi yang menjelaskan pita atau drive pita.

Sintaks

DWORD GetTapeParameters(
  [in]  HANDLE  hDevice,
  [in]  DWORD   dwOperation,
  [out] LPDWORD lpdwSize,
  [out] LPVOID  lpTapeInformation
);

Parameter

[in] hDevice

Tangani ke perangkat tentang informasi mana yang dicari. Handel ini dibuat dengan menggunakan fungsi CreateFile .

[in] dwOperation

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

Nilai	Makna
GET_TAPE_DRIVE_INFORMATION 1	Mengambil informasi tentang perangkat pita.
GET_TAPE_MEDIA_INFORMATION 0	Mengambil informasi tentang pita di perangkat pita.

[out] lpdwSize

Penunjuk ke variabel yang menerima ukuran, dalam byte, dari buffer yang ditentukan oleh parameter lpTapeInformation . Jika buffer terlalu kecil, parameter ini menerima ukuran yang diperlukan.

[out] lpTapeInformation

Penunjuk ke struktur yang berisi informasi yang diminta. Jika parameter dwOperationGET_TAPE_MEDIA_INFORMATION, lpTapeInformation menunjuk ke struktur TAPE_GET_MEDIA_PARAMETERS .

Jika dwOperationGET_TAPE_DRIVE_INFORMATION, lpTapeInformation menunjuk ke struktur TAPE_GET_DRIVE_PARAMETERS .

Nilai kembali

Jika fungsi berhasil, nilai yang dikembalikan adalah NO_ERROR.

Jika fungsi gagal, fungsi dapat mengembalikan salah satu kode kesalahan berikut.

Kode 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

Nilai rentang ukuran blok (maksimum dan minimum) yang dikembalikan oleh fungsi GetTapeParameters yang disebut dengan parameter dwOperation yang diatur ke nilai GET_TAPE_DRIVE_INFORMATION akan menunjukkan batas sistem, bukan batas drive. Namun, ini adalah perangkat tape drive dan media yang ada di drive yang menentukan batas ukuran blok yang benar. Dengan demikian, aplikasi mungkin tidak dapat mengatur semua ukuran blok yang disebutkan dalam rentang yang diperoleh dengan menentukan GET_TAPE_DRIVE_INFORMATION dalam dwOperation.

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

SetTapeParameters

TAPE_GET_DRIVE_PARAMETERS

TAPE_GET_MEDIA_PARAMETERS

Bagikan melalui