Fungsi ChangerGetParameters (mcd.h)
ChangerGetParameters menangani aspek khusus perangkat dari IRP kontrol perangkat dengan kode IOCTL IOCTL_CHANGER_GET_PARAMETERS.
Sintaks
NTSTATUS ChangerGetParameters(
[in] PDEVICE_OBJECT DeviceObject,
[in] PIRP Irp
);
Parameter
[in] DeviceObject
Arahkan ke objek perangkat yang mewakili pengubah.
[in] Irp
Arahkan ke IRP.
Mengembalikan nilai
ChangerGetParameters mengembalikan nilai STATUS_XXX yang dikembalikan oleh driver port sistem atau salah satu nilai berikut:
STATUS_SUCCESS
STATUS_INFO_LENGTH_MISMATCH
STATUS_INSUFFICIENT_RESOURCES
Keterangan
Rutinitas ini diperlukan.
ChangerGetParameters mengembalikan parameter pengubah, termasuk jumlah dan jenis elemennya dan fungsionalitas yang didukungnya.
Driver kelas pengubah memeriksa panjang buffer output di lokasi tumpukan I/O sebelum memanggil ChangerGetParameters. Jika panjang buffer output lebih kecil dari sizeof(GET_CHANGER_PARAMETERS) driver kelas changer akan kembali dengan nilai STATUS_INFO_LENGTH_MISMATCH.
ChangerGetParameters mengambil data parameter dari perangkat dengan membangun SRB dengan CDB untuk mendapatkan halaman header parameter SCSI, halaman alamat elemen, halaman geometri transportasi, dan halaman kemampuan perangkat, atau yang setara dengan data ini.
ChangerGetParameters kemudian mengisi struktur GET_CHANGER_PARAMETERS di Irp-AssociatedIrp.SystemBuffer> sebelum kembali ke driver kelas changer.
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Target Platform | Desktop |
| Header | mcd.h (termasuk Mcd.h, Ntddchgr.h) |
| IRQL | PASSIVE_LEVEL |