struktur TAPE_GET_DRIVE_PARAMETERS (ntddtape.h)
Struktur TAPE_GET_DRIVE_PARAMETERS digunakan bersama dengan permintaan IOCTL_TAPE_GET_DRIVE_PARAMS untuk mengambil informasi tentang kemampuan drive pita.
Sintaks
typedef struct _TAPE_GET_DRIVE_PARAMETERS {
BOOLEAN ECC;
BOOLEAN Compression;
BOOLEAN DataPadding;
BOOLEAN ReportSetmarks;
ULONG DefaultBlockSize;
ULONG MaximumBlockSize;
ULONG MinimumBlockSize;
ULONG MaximumPartitionCount;
ULONG FeaturesLow;
ULONG FeaturesHigh;
ULONG EOTWarningZoneSize;
} TAPE_GET_DRIVE_PARAMETERS, *PTAPE_GET_DRIVE_PARAMETERS;
Anggota
ECC
Ketika diatur ke TRUE, menunjukkan bahwa perangkat menggunakan koreksi kesalahan perangkat keras.
Compression
Ketika diatur ke TRUE, menunjukkan bahwa kompresi diaktifkan pada perangkat yang mendukungnya. Saat pemadatan diaktifkan, perangkat memadatkan data sebelum menulisnya. Ketika diatur ke FALSE, pemadatan tidak diaktifkan pada perangkat.
DataPadding
Saat diatur ke TRUE, menunjukkan bahwa padding data diaktifkan pada perangkat yang mendukungnya. Saat padding diaktifkan, perangkat melakukan pad data dengan nol untuk menjaga streaming pita hingga data siap. Saat diatur ke FALSE, padding data tidak diaktifkan.
ReportSetmarks
Saat diatur ke TRUE, menunjukkan bahwa setmark pelaporan diaktifkan pada perangkat yang mendukungnya. Perangkat melaporkan tanda set yang ditemui selama operasi baca atau ruang. Ketika diatur ke FALSE, setmark pelaporan tidak diaktifkan.
DefaultBlockSize
Menunjukkan ukuran blok default, dalam byte.
MaximumBlockSize
Menunjukkan ukuran blok maksimum, dalam byte, baik dari perangkat pita atau adaptor bus host (HBA) yang mendasar, mana pun yang lebih kecil.
MinimumBlockSize
Menunjukkan ukuran blok minimum, dalam byte.
MaximumPartitionCount
Menunjukkan jumlah maksimum partisi yang didukung perangkat.
FeaturesLow
Menunjukkan fitur yang didukung oleh drive ini. Driver miniport menetapkan bendera TAPE_DRIVE_XXX untuk fitur yang didukung oleh drive dan menghapus bendera untuk fitur yang tidak didukung. Penelepon dapat menggunakan masker TAPE_DRIVE_XXX yang ditentukan dalam minitape.h untuk menentukan apakah drive mendukung fitur tertentu. Masker yang tersedia adalah sebagai berikut:
| Mask | Makna |
|---|---|
| TAPE_DRIVE_CLEAN_REQUESTS | Perangkat dapat melaporkan apakah perlu dibersihkan. |
| TAPE_DRIVE_COMPRESSION | Perangkat mendukung pemadatan data perangkat keras. |
| TAPE_DRIVE_ECC | Perangkat mendukung koreksi kesalahan perangkat keras. |
| TAPE_DRIVE_EJECT_MEDIA | Perangkat mengeluarkan media. |
| TAPE_DRIVE_EOT_WZ_SIZE | Perangkat dapat melaporkan akhir ukuran peringatan zona. |
| TAPE_DRIVE_ERASE_BOP_ONLY | Perangkat melakukan operasi penghapusan hanya dari penanda awal partisi. |
| TAPE_DRIVE_ERASE_IMMEDIATE | Perangkat melakukan operasi penghapusan segera ?? artinya, ia kembali ketika operasi penghapusan dimulai. |
| TAPE_DRIVE_ERASE_LONG | Perangkat melakukan operasi penghapusan yang lama. |
| TAPE_DRIVE_ERASE_SHORT | Perangkat melakukan operasi penghapusan singkat. |
| TAPE_DRIVE_FIXED | Perangkat membuat partisi data tetap. |
| TAPE_DRIVE_FIXED_BLOCK | Perangkat mendukung mode blok panjang tetap. |
| TAPE_DRIVE_INITIATOR | Perangkat membuat partisi yang ditentukan inisiator. |
| TAPE_DRIVE_GET_ABSOLUTE_BLK | Perangkat menyediakan alamat blok khusus perangkat saat ini. |
| TAPE_DRIVE_GET_LOGICAL_BLK | Perangkat menyediakan alamat blok logis saat ini (dan partisi pita logis). |
| TAPE_DRIVE_PADDING | Perangkat mendukung padding data. |
| TAPE_DRIVE_REPORT_SMKS | Perangkat mendukung pelaporan setmark. |
| TAPE_DRIVE_RESERVED_BIT | Masker yang mengidentifikasi bit yang dipesan. Driver tidak boleh menyetel bit ini. |
| TAPE_DRIVE_SELECT | Perangkat membuat partisi data tertentu. |
| TAPE_DRIVE_SET_CMP_BOP_ONLY | Perangkat hanya memungkinkan pemadatan diaktifkan ketika kepala baca/tulis berada di awal partisi. |
| TAPE_DRIVE_SET_EOT_WZ_SIZE | Perangkat mendukung pengaturan ukuran peringatan akhir-sedang. |
| TAPE_DRIVE_TAPE_CAPACITY | Perangkat mengembalikan kapasitas maksimum pita. |
| TAPE_DRIVE_TAPE_REMAINING | Perangkat mengembalikan kapasitas pita yang tersisa. |
| TAPE_DRIVE_VARIABLE_BLOCK | Perangkat mendukung mode blok panjang variabel. |
| TAPE_DRIVE_WRITE_PROTECT | Perangkat mengembalikan kesalahan jika pita diaktifkan untuk menulis atau dilindungi penulisan. |
FeaturesHigh
Menunjukkan fitur tambahan yang didukung oleh drive ini jika TAPE_DRIVE_HIGH_FEATURES diatur dalam FeaturesLow. Driver miniport menetapkan bendera TAPE_DRIVE_XXX untuk fitur yang didukung oleh drive dan menghapus bendera untuk fitur yang tidak didukung. Penelepon dapat menggunakan masker TAPE_DRIVE_XXX yang ditentukan dalam minitape.h untuk menentukan apakah drive mendukung fitur tertentu.
| Mask | Makna |
|---|---|
| TAPE_DRIVE_ABS_BLK_IMMED | Perangkat memindahkan pita ke alamat blok khusus perangkat dan kembali segera setelah pemindahan dimulai. |
| TAPE_DRIVE_ABSOLUTE_BLK | Perangkat memindahkan pita ke alamat blok tertentu perangkat. |
| TAPE_DRIVE_END_OF_DATA | Perangkat memindahkan pita ke penanda akhir data dalam partisi. |
| TAPE_DRIVE_FILEMARKS | Perangkat memindahkan pita ke depan (atau mundur) sejumlah marka file tertentu. |
| TAPE_DRIVE_FORMAT | Perangkat dapat memformat media. |
| TAPE_DRIVE_FORMAT_IMMEDIATE | Perangkat dapat memformat media sebagai perintah langsung. |
| TAPE_DRIVE_HIGH_FEATURES | Bitmask yang menunjukkan bit yang sesuai dengan fitur tinggi. |
| TAPE_DRIVE_LOAD_UNLOAD | Perangkat mengaktifkan dan menonaktifkan perangkat untuk operasi lebih lanjut. |
| TAPE_DRIVE_LOAD_UNLD_IMMED | Perangkat mendukung operasi pemuatan dan pembongkaran segera. |
| TAPE_DRIVE_LOCK_UNLOCK | Perangkat mengaktifkan dan menonaktifkan mekanisme ejeksi pita. |
| TAPE_DRIVE_LOCK_UNLK_IMMED | Perangkat mendukung operasi kunci dan buka kunci segera. |
| TAPE_DRIVE_LOG_BLK_IMMED | Perangkat memindahkan pita ke alamat blok logis dalam partisi dan kembali segera setelah pemindahan dimulai. |
| TAPE_DRIVE_LOGICAL_BLK | Perangkat memindahkan pita ke alamat blok logis dalam partisi. |
| TAPE_DRIVE_RELATIVE_BLKS | Perangkat memindahkan pita ke depan (atau mundur) sejumlah blok tertentu. |
| TAPE_DRIVE_REVERSE_POSITION | Perangkat memindahkan pita ke belakang melalui blok, tanda file, atau tanda set. |
| TAPE_DRIVE_REWIND_IMMEDIATE | Perangkat mendukung operasi putar balik segera. |
| TAPE_DRIVE_SEQUENTIAL_FMKS | Perangkat memindahkan pita ke depan (atau mundur) ke kemunculan pertama dari sejumlah marka file berturut-turut yang ditentukan. |
| TAPE_DRIVE_SEQUENTIAL_SMKS | Perangkat memindahkan pita ke depan (atau mundur) ke kemunculan pertama dari sejumlah setmark berturut-turut yang ditentukan. |
| TAPE_DRIVE_SET_BLOCK_SIZE | Perangkat mendukung pengaturan ukuran blok logis panjang tetap atau mengatur mode blok panjang variabel. |
| TAPE_DRIVE_SET_COMPRESSION | Perangkat mengaktifkan dan menonaktifkan pemadatan data perangkat keras. |
| TAPE_DRIVE_SET_ECC | Perangkat memfungsikan dan menonaktifkan koreksi kesalahan perangkat keras. |
| TAPE_DRIVE_SET_PADDING | Perangkat mengaktifkan dan menonaktifkan padding data. |
| TAPE_DRIVE_SET_REPORT_SMKS | Perangkat mengaktifkan dan menonaktifkan pelaporan setmark. |
| TAPE_DRIVE_SETMARKS | Perangkat memindahkan pita ke depan (atau membalikkan) jumlah setmark yang ditentukan. |
| TAPE_DRIVE_SPACE_IMMEDIATE | Perangkat mendukung penspasian langsung. |
| TAPE_DRIVE_TENSION | Perangkat mendukung ketegangan pita. |
| TAPE_DRIVE_TENSION_IMMED | Perangkat mendukung ketegangan pita langsung. |
| TAPE_DRIVE_WRITE_FILEMARKS | Perangkat menulis tanda file. |
| TAPE_DRIVE_WRITE_LONG_FMKS | Perangkat menulis tanda file panjang. |
| TAPE_DRIVE_WRITE_MARK_IMMED | Perangkat ini mendukung penulisan segera marka file pendek dan panjang. |
| TAPE_DRIVE_WRITE_SETMARKS | Perangkat menulis setmark. |
| TAPE_DRIVE_WRITE_SHORT_FMKS | Perangkat menulis tanda file pendek. |
EOTWarningZoneSize
Menunjukkan ukuran dalam byte zona peringatan dini menuju akhir pita. Perangkat mengembalikan kondisi pemeriksaan saat memasuki zona.
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Header | ntddtape.h (termasuk Ntddtape.h, Minitape.h) |