Fungsi ChangerInitialize (mcd.h)
ChangerInitialize membaca pengubah untuk menerima permintaan lain.
Sintaks
NTSTATUS ChangerInitialize(
[in] PDEVICE_OBJECT DeviceObject
);
Parameter
[in] DeviceObject
Arahkan ke objek perangkat yang dibuat oleh driver kelas pengubah untuk mewakili pengubah ini.
Mengembalikan nilai
ChangerInitialize mengembalikan nilai STATUS_XXX yang dikembalikan oleh driver port sistem atau salah satu nilai berikut:
STATUS_SUCCESS
STATUS_INSUFFICIENT_RESOURCES
Keterangan
Driver kelas pengubah memanggil ChangerInitialize selama inisialisasi driver, setelah membuat objek perangkat untuk mewakili pengubah.
ChangerInitialize melakukan pemrosesan khusus perangkat apa pun yang diperlukan untuk membuat pengubah siap menerima permintaan. Ini juga biasanya menyimpan informasi khusus perangkat dalam ekstensi perangkat, seperti data pertanyaan SCSI atau setara non-SCSI dan offset untuk menghasilkan alamat elemen berbasis nol, yang digunakan oleh sistem untuk merujuk ke elemen pengubah.
Setelah ChangerInitialize kembali, changer meminimalkan driver dan changer harus dapat menangani permintaan lain.
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Target Platform | Desktop |
| Header | mcd.h (termasuk Mcd.h, Ntddchgr.h) |
| IRQL | PASSIVE_LEVEL |