Fungsi ChangerGetElementStatus (mcd.h)

Artikel
02/26/2024

ChangerGetElementStatus menangani aspek khusus perangkat dari IRP kontrol perangkat dengan kode IOCTL IOCTL_CHANGER_GET_ELEMENT_STATUS.

Sintaks

NTSTATUS ChangerGetElementStatus(
  [in] PDEVICE_OBJECT DeviceObject,
  [in] PIRP           Irp
);

Parameter

[in] DeviceObject

Arahkan ke objek perangkat yang mewakili pengubah.

[in] Irp

Arahkan ke IRP.

Nilai kembali

ChangerGetElementStatus mengembalikan status yang dikembalikan oleh driver port sistem atau salah satu nilai berikut:

STATUS_SUCCESS

STATUS_INFO_LENGTH_MISMATCH

STATUS_INSUFFICIENT_RESOURCES

STATUS_INVALID_DEVICE_REQUEST

STATUS_INVALID_ELEMENT_ADDRESS

Jika VolumeTagInfo diatur untuk pengubah yang tidak mendukung informasi tag volume, ChangerGetElementStatus mengembalikan STATUS_INVALID_PARAMETER.

Keterangan

Rutinitas ini diperlukan.

ChangerGetElementStatus mengembalikan status dan, secara opsional, informasi tag volume untuk semua elemen dalam pengubah, atau status jumlah elemen tertentu dari jenis tertentu.

Driver kelas pengubah memeriksa panjang buffer input dan output di lokasi tumpukan I/O sebelum memanggil ChangerGetElementStatus.

Irp-SystemBuffer> menunjuk ke struktur CHANGER_READ_ELEMENT_STATUS sebagai parameter input yang menunjukkan elemen yang akan melaporkan status dan apakah akan melaporkan informasi tag volume.

ChangerGetElementStatus pertama-tama membangun SRB dengan CDB untuk membaca perintah status elemen dan mengirimkannya ke driver port sistem untuk mengambil status elemen pengubah. Untuk sebagian besar jenis elemen, ChangerGetElementStatus kemudian mengisi struktur CHANGER_ELEMENT_STATUS di Irp-AssociatedIrp.SystemBuffer> untuk setiap elemen yang melaporkan statusnya. Namun, beberapa elemen jenis ChangerDrive mengembalikan data informasi produk. Jika perangkat memberikan informasi produk, driver miniclass harus melaporkan data status elemen dalam struktur jenis CHANGER_ELEMENT_STATUS_EX alih-alih menggunakan CHANGER_ELEMENT_STATUS. ChangerGetElementStatus harus menunjukkan bahwa informasi produk ada dengan mengatur ELEMENT_STATUS_PRODUCT_DATA di anggota Bendera struktur.

ChangerGetElementStatus mengatur bidang Informasi di blok status I/O ke jumlah byte yang dikembalikan sebelum kembali ke driver kelas pengubah.