Fungsi ChangerGetProductData (mcd.h)

ChangerGetProductData menangani aspek khusus perangkat dari IRP kontrol perangkat dengan kode IOCTL IOCTL_CHANGER_GET_PRODUCT_DATA.

Sintaks

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

Parameter

[in] DeviceObject

Arahkan ke objek perangkat yang mewakili pengubah.

[in] Irp

Arahkan ke IRP.

Nilai kembali

ChangerGetProductData selalu mengembalikan STATUS_SUCCESS.

Keterangan

Rutinitas ini diperlukan.

ChangerGetProductData mengembalikan data produk untuk pengubah.

Driver kelas pengubah memeriksa panjang buffer output di lokasi tumpukan I/O sebelum memanggil ChangerGetProductData. Jika panjang buffer output lebih kecil dari sizeof(CHANGER_PRODUCT_DATA) maka driver kelas changer mengembalikan dengan nilai STATUS_INFO_LENGTH_MISMATCH

ChangerGetProductData mengisi struktur CHANGER_PRODUCT_DATA di Irp-AssociatedIrp.SystemBuffer> sebelum kembali ke driver kelas changer. Jika driver miniclass menyimpan data pertanyaan dalam ekstensi perangkat pengubah sebelum kembali dari ChangerInitialize, semua anggota kecuali DeviceType dapat diisi dari data ini.

Persyaratan

Persyaratan Nilai
Target Platform Desktop
Header mcd.h (termasuk Mcd.h, Ntddchgr.h)
IRQL PASSIVE_LEVEL

Lihat juga

CHANGER_PRODUCT_DATA

ChangerInitialize