struktur GET_CHANGER_PARAMETERS (ntddchgr.h)

Artikel
08/07/2023

Mengambil karakteristik pengubah.

Sintaks

typedef struct _GET_CHANGER_PARAMETERS {
  ULONG  Size;
  USHORT NumberTransportElements;
  USHORT NumberStorageElements;
  USHORT NumberCleanerSlots;
  USHORT NumberIEElements;
  USHORT NumberDataTransferElements;
  USHORT NumberOfDoors;
  USHORT FirstSlotNumber;
  USHORT FirstDriveNumber;
  USHORT FirstTransportNumber;
  USHORT FirstIEPortNumber;
  USHORT FirstCleanerSlotAddress;
  USHORT MagazineSize;
  ULONG  DriveCleanTimeout;
  ULONG  Features0;
  ULONG  Features1;
  UCHAR  MoveFromTransport;
  UCHAR  MoveFromSlot;
  UCHAR  MoveFromIePort;
  UCHAR  MoveFromDrive;
  UCHAR  ExchangeFromTransport;
  UCHAR  ExchangeFromSlot;
  UCHAR  ExchangeFromIePort;
  UCHAR  ExchangeFromDrive;
  UCHAR  LockUnlockCapabilities;
  UCHAR  PositionCapabilities;
  UCHAR  Reserved1[2];
  ULONG  Reserved2[2];
} GET_CHANGER_PARAMETERS, *PGET_CHANGER_PARAMETERS;

Anggota

Size

Ukuran struktur ini dalam byte. Atur ke sizeof(GET_CHANGER_PARAMETERS). Akibatnya, anggota ini menunjukkan versi struktur ini yang digunakan oleh driver miniclass.

NumberTransportElements

Menunjukkan jumlah elemen transportasi dalam pengubah. Untuk pengubah SCSI, ini didefinisikan di halaman alamat elemen. Nilai ini hampir selalu 1, karena sebagian besar pengubah memiliki elemen transportasi tunggal, yang dapat memiliki satu atau dua mekanisme pemilih. Pengubah yang memiliki dua mekanisme pemilih pada transportasinya tidak boleh direpresentasikan sebagai memiliki dua transportasi, karena pemilih tidak dapat ditangani secara individual. Pustaka media kelas atas dapat memiliki dual dan beberapa elemen transportasi untuk toleransi kesalahan.

NumberStorageElements

Menunjukkan jumlah elemen penyimpanan (slot) dalam pengubah. Untuk pengubah SCSI, ini didefinisikan di halaman alamat elemen. Nilai ini menunjukkan jumlah maksimum slot yang tersedia untuk pengubah ini, termasuk yang ada di majalah yang dapat dilepas, apakah majalah dipasang. Jika NumberCleanerSlots adalah 1, maka NumberStorageElements adalah 1 kurang dari jumlah maksimum slot dalam pengubah.

NumberCleanerSlots

Menunjukkan jumlah elemen penyimpanan (slot) untuk kartrid yang lebih bersih di pengubah. Untuk pengubah SCSI, nilai ini tidak dilaporkan dalam mode sense data, sehingga driver miniclass harus menyediakannya. Driver miniclass harus mengatur NumberCleanerSlots ke 1 hanya jika panduan operator untuk changer mengidentifikasi slot tertentu sebagai slot yang lebih bersih. Jika NumberCleanerSlots adalah 1, maka FirstCleanerSlotAddress menunjukkan alamat slot berbasis nol tempat pembersih drive harus dimasukkan. Jika pengubah tidak mendukung pembersihan drive dengan memindahkan kartrid pembersih secara terprogram dari slotnya ke drive, driver miniclass harus mengatur NumberCleanerSlots ke 0. NumberCleanerSlots tidak boleh lebih besar dari 1.

NumberIEElements

Menunjukkan jumlah elemen IEport yang dimiliki pengubah untuk menyisipkan dan mengeluarkan media. Untuk pengubah SCSI, ini didefinisikan di halaman alamat elemen. Elemen IEport tidak boleh menjadi bagian dari ruang elemen penyimpanan (slot), dan harus dimungkinkan untuk mengangkut media antara IEport dan slot menggunakan perintah MOVE MEDIUM SCSI. Jika pengubah memiliki pintu dan bukan IEport yang benar, driver miniclass harus mengatur NumberIEElements ke 0.

NumberDataTransferElements

Menunjukkan jumlah elemen transfer data (drive) dalam pengubah. Untuk pengubah SCSI, ini didefinisikan di halaman alamat elemen. Tidak seperti NumberStorageElements, yang menunjukkan jumlah total slot yang mungkin apakah slot benar-benar ada, NumberDataTransferElements menunjukkan jumlah drive yang benar-benar ada di pengubah.

NumberOfDoors

Menunjukkan jumlah pintu yang dimiliki pengubah. Untuk pengubah SCSI, nilai ini tidak dilaporkan dalam mode sense data, sehingga driver miniclass harus menyediakannya. Pintu menyediakan akses ke semua media di pengubah sekaligus, tidak seperti IEport yang menyediakan akses ke satu atau beberapa, tetapi tidak semua, media. Pintu pengubah dapat berupa pintu depan fisik atau majalah tunggal yang berisi semua media. Jika pengubah hanya mendukung IEport untuk menyisipkan dan mengeluarkan media, NumberOfDoors harus 0.

FirstSlotNumber

Menunjukkan nomor yang digunakan oleh vendor pengubah untuk mengidentifikasi elemen penyimpanan pertama (slot) di pengubah kepada pengguna akhir, baik dengan menandai majalah atau dengan menentukan skema penomoran slot dalam panduan operator pengubah. FirstSlotNumber biasanya 0 atau 1, tetapi dapat menjadi alamat pertama dalam berbagai alamat slot berturut-turut yang ditentukan oleh vendor.

FirstDriveNumber

Menunjukkan nomor yang digunakan oleh vendor pengubah untuk mengidentifikasi elemen transfer data (drive) pertama di pengubah kepada pengguna akhir. FirstDriveNumber biasanya 0 atau 1, tetapi dapat menjadi alamat pertama dalam rentang alamat drive berturut-turut yang ditentukan oleh vendor.

FirstTransportNumber

Menunjukkan nomor yang digunakan oleh vendor pengubah untuk mengidentifikasi elemen transportasi pertama (dan biasanya hanya) di pengubah kepada pengguna akhir. FirstTransportNumber biasanya 0 atau 1, tetapi dapat menjadi alamat pertama dalam berbagai alamat transportasi berturut-turut yang ditentukan oleh vendor.

FirstIEPortNumber

Menunjukkan nomor yang digunakan oleh vendor pengubah untuk mengidentifikasi IEport pertama (dan biasanya hanya) di pengubah kepada pengguna akhir. FirstIEPortNumber biasanya 0 atau 1, tetapi dapat menjadi alamat pertama dalam berbagai alamat IEport berturut-turut yang ditentukan oleh vendor. Jika NumberIEElements adalah 0, FirstIEPortNumber juga harus 0.

FirstCleanerSlotAddress

Menunjukkan nomor yang digunakan oleh vendor pengubah untuk mengidentifikasi alamat slot pertama (dan hanya) yang ditetapkan ke kartrid pembersih drive kepada pengguna akhir. Ini harus menjadi nilai yang ditentukan oleh vendor dalam panduan operator pengubah. Misalnya, jika pengubah memiliki 8 slot bernomor 1 hingga 8 dan panduan operatornya menunjuk slot 8 sebagai slot pembersih drive, FirstSlotNumber akan menjadi 1 dan FirstCleanerSlotAddress adalah 8. Jika 8 slot yang sama diberi nomor 0 hingga 7, FirstSlotNumber akan menjadi 0 dan FirstCleanerSlotAddress akan menjadi 7. Jika NumberCleanerSlots adalah 0, FirstCleanerSlotAddress harus 0.

MagazineSize

Menunjukkan jumlah slot di majalah yang dapat dilepas di pengubah. Anggota ini hanya valid jika CHANGER_CARTRIDGE_MAGAZINE diatur di Fitur0.

DriveCleanTimeout

Menunjukkan dua kali jumlah maksimum detik yang akan diambil oleh pembersihan. Drive pengubah harus dibersihkan dengan kartrid pembersihnya dalam setengah waktu yang ditentukan oleh DriveCleanTimeout. Misalnya, jika drive biasanya dibersihkan dalam 300 detik (5 menit), DriveCleanTimeout harus diatur ke 600.

Features0

Menunjukkan fitur yang didukung oleh pengubah. Anggota ini dapat memiliki satu atau beberapa nilai berikut bitwise ORed bersama-sama.

CHANGER_BAR_CODE_SCANNER_INSTALLED

Pengubah mendukung pembaca kode batang dan pembaca diinstal. Driver miniclass tidak boleh mengodekan bendera ini kecuali pembaca kode batang pengubah selalu diinstal. Jika pembaca kode batang bersifat opsional, driver miniclass harus menentukan apakah pembaca benar-benar diinstal dan mengatur bendera yang sesuai.

CHANGER_INIT_ELEM_STAT_WITH_RANGE

Pengubah dapat menginisialisasi elemen dalam rentang tertentu. Untuk pengubah SCSI, bendera ini menunjukkan apakah pengubah mendukung perintah INITIALIZE ELEMENT STATUS WITH RANGE SCSI.

CHANGER_CLOSE_IEPORT

Pengubah memiliki IEport dan dapat mencabut IEport secara terprogram.

CHANGER_OPEN_IEPORT

Pengubah memiliki IEport dan dapat memperluas IEport secara terprogram.

CHANGER_STATUS_NON_VOLATILE

Pengubah menggunakan memori nonvolatile untuk informasi status elemen.

CHANGER_EXCHANGE_MEDIA

Mendukung perintah EXCHANGE MEDIUM SCSI baik dengan menangani dua volume pada satu waktu atau dengan menggunakan elemen pengubah lain untuk meniru kemampuan ini.

CHANGER_CLEANER_SLOT

Menunjukkan bahwa pengubah memiliki slot tertentu yang ditunjuk untuk kartrid yang lebih bersih. Jika bendera ini diatur, NumberCleanerSlots harus satu dan FirstCleanerSlotAddress harus menentukan alamat slot pembersih. Bit ini hanya dapat diatur jika CHANGER_DRIVE_CLEANING_REQUIRED diatur dan CHANGER_CLEANER_OPS_NOT_SUPPORTED diatur ulang.

CHANGER_LOCK_UNLOCK

Pintu, IEport, atau keypad pengubah dapat dikunci atau dibuka secara terprogram. Jika bendera ini diatur, LockUnlockCapabilities menunjukkan elemen mana yang dapat dikunci atau dibuka kuncinya.

CHANGER_CARTRIDGE_MAGAZINE

Pengubah menggunakan majalah kartrid yang dapat dilepas untuk beberapa atau semua slot penyimpanan.

CHANGER_MEDIUM_FLIP

Elemen transportasi pengubah mendukung membalik (memutar) media. Untuk pengubah SCSI, bendera ini mencerminkan bit putar di halaman parameter geometri transportasi.

CHANGER_POSITION_TO_ELEMENT

Pengubah dapat memposisikan transportasi ke tujuan tertentu. Untuk pengubah SCSI, bendera ini menunjukkan apakah pengubah mendukung perintah POSITION TO ELEMENT SCSI. Jika bendera ini diatur, PositionCapabilities menunjukkan elemen tempat transportasi dapat diposisikan.

CHANGER_REPORT_IEPORT_STATE

Pengubah dapat melaporkan apakah media ada di IEport. Pengubah semacam itu harus memiliki sensor di IEport untuk mendeteksi keberadaan atau tidak adanya media.

CHANGER_STORAGE_DRIVE

Pengubah dapat menggunakan drive sebagai elemen penyimpanan independen; yaitu, dapat menyimpan media di drive tanpa membacanya. Untuk pengubah SCSI, bendera ini mencerminkan status bit DT di halaman kemampuan perangkat.

CHANGER_STORAGE_IEPORT

Pengubah dapat menggunakan IEport sebagai elemen penyimpanan independen. Untuk pengubah SCSI, bendera ini mencerminkan status bit I/E di halaman kemampuan perangkat.

CHANGER_STORAGE_SLOT

Pengubah dapat menggunakan slot sebagai elemen penyimpanan independen untuk media. Untuk pengubah SCSI, bendera ini mencerminkan status bit ST di halaman kemampuan perangkat. Slot adalah lokasi penyimpanan normal untuk media, sehingga pengubah harus mendukung fungsionalitas ini.

CHANGER_STORAGE_TRANSPORT

Pengubah dapat menggunakan transportasi sebagai elemen penyimpanan independen. Untuk pengubah SCSI, bendera ini mencerminkan status bit MT di halaman kemampuan perangkat.

CHANGER_DRIVE_CLEANING_REQUIRED

Menunjukkan bahwa drive pengubah mungkin secara berkala melaporkan kode pengertian yang menunjukkan bahwa drive memerlukan pembersihan.

CHANGER_PREDISMOUNT_EJECT_REQUIRED

Pengubah memerlukan perintah eksplisit yang dikeluarkan melalui driver penyimpanan massal (pita, disk, atau CD-ROM, misalnya) untuk mengeluarkan media dari drive sebelum pengubah dapat memindahkan media dari drive ke slot. Jika pengubah mengeluarkan media secara otomatis, driver miniclass harus menghapus bendera ini.

CHANGER_CLEANER_ACCESS_NOT_VALID

Bendera ELEMENT_STATUS_ACCESS dalam struktur CHANGER_ELEMENT_STATUS untuk elemen transportasi data tidak valid ketika elemen transportasi berisi kartrid pembersih.

CHANGER_DRIVE_EMPTY_ON_DOOR_ACCESS

Pengubah mengharuskan semua drive kosong (dilepas) sebelum dapat diakses melalui pintunya. Driver miniclass harus mengatur bendera ini jika pengubah memiliki drive sensitif statis yang dapat dipengaruhi oleh operator yang mendapatkan akses ke bagian dalam pengubah, atau jika pengubah secara otomatis mengeluarkan media dari drivenya ketika operator mencoba membuka pintu secara fisik.

CHANGER_VOLUME_IDENTIFICATION

Pengubah mendukung identifikasi volume. Untuk pengubah SCSI, bendera ini menunjukkan apakah pengubah mendukung perintah SEND VOLUME TAG dan REQUEST VOLUME ELEMENT ADDRESS SCSI.

CHANGER_VOLUME_SEARCH

Pengubah dapat mencari informasi volume. Untuk pengubah SCSI, bendera ini menunjukkan apakah pengubah mendukung perintah SEND VOLUME TAG SCSI dengan kode tindakan kirim TERJEMAHAN.

CHANGER_VOLUME_ASSERT

Pengubah dapat memverifikasi informasi volume. Untuk pengubah SCSI, bendera ini menunjukkan apakah pengubah mendukung perintah SEND VOLUME TAG SCSI dengan kode tindakan kirim ASSERT.

CHANGER_VOLUME_REPLACE

Pengubah dapat menggantikan informasi volume. Untuk pengubah SCSI, bendera ini menunjukkan apakah pengubah mendukung perintah SEND VOLUME TAG SCSI dengan kode tindakan kirim REPLACE.

CHANGER_VOLUME_UNDEFINE

Pengubah dapat menghapus informasi volume yang ada. Untuk pengubah SCSI, bendera ini menunjukkan apakah pengubah mendukung perintah SEND VOLUME TAG SCSI dengan kode tindakan kirim UNDEFINE.

CHANGER_SERIAL_NUMBER_VALID

Nomor seri yang dilaporkan oleh GetProductData valid dan unik untuk semua pengubah jenis ini. Nomor seri tidak dijamin unik di seluruh vendor dan lini produk. Jika nomor seri pengubah unik sesuai dengan definisi ini, driver miniclass harus mengatur bendera ini dan mengatur SerialNumber di CHANGER_PRODUCT_DATA ke nomor seri.

CHANGER_PREMOUNT_EJECT_REQUIRED

Pengubah memerlukan perintah eksplisit yang dikeluarkan melalui driver penyimpanan massal untuk mengeluarkan mekanisme drive sebelum pengubah dapat memindahkan media dari slot ke drive. Misalnya, pengubah dengan drive CD-ROM mungkin memerlukan baki untuk disajikan ke transportasi robotik sehingga sepotong media dapat dimuat ke baki selama operasi pemasangan. Jika pengubah mengeluarkan mekanisme secara otomatis, driver miniclass harus menghapus bendera ini.

CHANGER_DEVICE_REINITIALIZE_CAPABLE

Pengubah dapat mengkalibrasi ulang elemen transportasinya sebagai respons terhadap perintah eksplisit. Driver kelas pengubah memanggil ChangerReinitializeUnit untuk memulai kalibrasi ulang.

CHANGER_KEYPAD_ENABLE_DISABLE

Keypad pengubah dapat diaktifkan dan dinonaktifkan secara terprogram.

CHANGER_RESERVED_BIT

Dicadangkan untuk menunjukkan bendera Features1 .

Features1

Menunjukkan fitur tambahan yang didukung oleh pengubah. Anggota ini dapat memiliki satu atau beberapa nilai berikut bitwise ORed bersama-sama.

CHANGER_PREDISMOUNT_ALIGN_TO_SLOT

Menunjukkan bahwa transportasi harus dipindahkan ke slot tujuan sebelum memindahkan media dari drive ke slot. Bit CHANGER_PREDISMOUNT_ALIGN_TO_DRIVE harus diatur ulang jika ini diatur.

CHANGER_PREDISMOUNT_ALIGN_TO_DRIVE

Menunjukkan bahwa transportasi harus dipindahkan ke drive sebelum memindahkan media dari drive ke slot. Bit CHANGER_PREDISMOUNT_ALIGN_TO_SLOT harus diatur ulang jika ini diatur.

CHANGER_CLEANER_AUTODISMOUNT

Menunjukkan bahwa pengubah akan memindahkan kartrid pembersih kembali ke slot aslinya secara otomatis, setelah pembersihan selesai. Bit ini hanya dapat diatur jika CHANGER_DRIVE_CLEANING_REQUIRED diatur dan CHANGER_CLEANER_OPS_NOT_SUPPORTED diatur ulang.

CHANGER_TRUE_EXCHANGE_CAPABLE

Perangkat dapat memanipulasi dua volume pada satu waktu tanpa menggunakan elemen pengubah tambahan.

CHANGER_SLOTS_USE_TRAYS

Pengubah menggunakan baki yang dapat dilepas di slotnya, yang mengharuskan media ditempatkan di baki dan baki dipindahkan ke posisi yang diinginkan.

CHANGER_RTN_MEDIA_TO_ORIGINAL_ADDR

Menunjukkan bahwa ketika memindahkan volume dari drive ke slot, volume harus kembali ke slot yang sama dari yang sebelumnya dipindahkan ke drive.

CHANGER_CLEANER_OPS_NOT_SUPPORTED

Menunjukkan bahwa transportasi pengubah tidak dapat dikomandoi secara terprogram oleh perangkat lunak di atas driver pengubah untuk memindahkan kartrid pembersih ke drive kotor. Bit ini hanya dapat diatur jika bit CHANGER_DRIVE_CLEANING_REQUIRED diatur. Jika bit ini diatur, maka CHANGER_CLEANER_AUTODISMOUNT dan CHANGER_CLEANER_SLOT harus diatur ulang.

CHANGER_IEPORT_USER_CONTROL_OPEN

Pengubah mengharuskan pengguna untuk membuka IEport tertutup secara manual.

CHANGER_IEPORT_USER_CONTROL_CLOSE

Pengubah mengharuskan pengguna untuk menutup IEport yang terbuka secara manual.

CHANGER_MOVE_EXTENDS_IEPORT

Pengubah akan memperluas baki secara otomatis setiap kali perintah dikeluarkan untuk memindahkan media ke IEport.

CHANGER_MOVE_RETRACTS_IEPORT

Pengubah akan mencabut baki secara otomatis setiap kali perintah dikeluarkan untuk memindahkan media dari IEport.

MoveFromTransport

Menunjukkan apakah pengubah mendukung pemindahan sepotong media dari elemen transportasi ke elemen transportasi lain, slot penyimpanan, IEport, atau drive. Untuk pengubah SCSI, ini didefinisikan di halaman kemampuan perangkat. Transportasi biasanya bukan sumber atau tujuan untuk memindahkan atau bertukar media.

Penelepon dapat menggunakan masker berikut untuk menentukan apakah pengubah dapat memindahkan media ke elemen tertentu.

CHANGER_TO_TRANSPORT

Pengubah dapat melakukan operasi dari elemen yang ditentukan ke transportasi.

CHANGER_TO_SLOT

Pengubah dapat melakukan operasi dari elemen yang ditentukan ke slot penyimpanan.

CHANGER_TO_IEPORT

Pengubah dapat melakukan operasi dari elemen yang ditentukan ke IEport.

CHANGER_TO_DRIVE

Pengubah dapat melakukan operasi dari elemen yang ditentukan ke drive.

MoveFromSlot

Menunjukkan apakah pengubah mendukung pemindahan media dari slot penyimpanan ke elemen transportasi, slot penyimpanan lain, IEport, atau drive. Penelepon dapat menggunakan masker yang dijelaskan di bawah MoveFromTransport untuk menentukan apakah pengubah mendukung pemindahan.

MoveFromIePort

Menunjukkan apakah pengubah mendukung pemindahan media dari IEport ke elemen transportasi, slot penyimpanan, IEport lain, atau drive. Untuk pengubah SCSI, ini didefinisikan di halaman kemampuan perangkat. Penelepon dapat menggunakan masker yang dijelaskan di bawah MoveFromTransport untuk menentukan apakah pengubah mendukung pemindahan

MoveFromDrive

Menunjukkan apakah pengubah mendukung pemindahan media dari drive ke elemen transportasi, slot penyimpanan, IEport, atau drive lain. Penelepon dapat menggunakan masker yang dijelaskan di bawah MoveFromTransport untuk menentukan apakah pengubah mendukung pemindahan.

ExchangeFromTransport

Menunjukkan apakah pengubah mendukung pertukaran media antara elemen transportasi dan elemen transportasi lain, slot penyimpanan, IEport, atau drive. Penelepon dapat menggunakan masker yang dijelaskan di bawah MoveFromTransport untuk menentukan apakah pengubah mendukung pertukaran.

ExchangeFromSlot

Menunjukkan apakah pengubah mendukung pertukaran media antara slot penyimpanan dan elemen transportasi, slot penyimpanan lain, IEport, atau drive. Penelepon dapat menggunakan masker yang dijelaskan di bawah MoveFromTransport untuk menentukan apakah pengubah mendukung pertukaran.

ExchangeFromIePort

Menunjukkan apakah pengubah mendukung pertukaran media antara IEport dan elemen transportasi, slot penyimpanan, IEport lain, atau drive. Penelepon dapat menggunakan masker yang dijelaskan di bawah MoveFromTransport untuk menentukan apakah pengubah mendukung pertukaran.

ExchangeFromDrive

Menunjukkan apakah pengubah mendukung pertukaran media antara drive dan elemen transportasi, slot penyimpanan, IEport, atau drive lain. Penelepon dapat menggunakan masker yang dijelaskan di bawah MoveFromTransport untuk menentukan apakah pengubah mendukung pertukaran.

LockUnlockCapabilities

Menunjukkan elemen pengubah mana yang dapat dikunci atau dibuka kuncinya secara terprogram. Anggota ini hanya valid jika CHANGER_LOCK_UNLOCK diatur di Fitur0.

Penelepon dapat menggunakan masker berikut untuk menentukan apakah pengubah dapat mengunci atau membuka kunci elemen tertentu.

LOCK_UNLOCK_IEPORT

Pengubah dapat mengunci atau membuka kunci IEport-nya.

LOCK_UNLOCK_DOOR

Pengubah dapat mengunci atau membuka kunci pintunya.

LOCK_UNLOCK_KEYPAD

Pengubah dapat mengunci atau membuka kunci keypad-nya.

PositionCapabilities

Menunjukkan elemen tempat pengubah dapat memposisikan transportasinya. Penelepon dapat menggunakan masker yang dijelaskan di bawah MoveFromTransport untuk menentukan apakah pengubah mendukung penempatan transportasi ke elemen tertentu. Anggota ini hanya valid jika CHANGER_POSITION_TO_ELEMENT diatur di Fitur0.

Reserved1[2]

Disiapkan untuk penggunaan masa mendatang.

Reserved2[2]