Fungsi ChangerClassInitialize (mcd.h)
Rutinitas ChangerClassInitialize menginisialisasi driver.
Sintaks
NTSTATUS ChangerClassInitialize(
[in] PDRIVER_OBJECT DriverObject,
[in] PUNICODE_STRING RegistryPath,
PMCD_INIT_DATA ChangerInitData
);
Parameter
[in] DriverObject
Arahkan ke objek driver miniclass pengubah. Ini diteruskan sebagai parameter ke rutinitas DriverEntry driver miniclass. Format objek ini khusus sistem operasi dan tidak boleh ditafsirkan oleh driver miniclass.
[in] RegistryPath
Arahkan ke jalur registri untuk driver miniclass pengubah. Ini juga diteruskan sebagai parameter ke rutinitas DriverEntry driver miniclass. Format ini khusus sistem operasi dan tidak boleh ditafsirkan oleh driver miniclass.
ChangerInitData
Arahkan ke struktur MCD_INIT_DATA yang berisi informasi khusus pengemudi miniclass seperti titik masuk untuk rutinitas pemrosesan perintah driver miniclass pengubah.
Nilai kembali
ChangerClassInitialize mengembalikan nilai yang menunjukkan keberhasilan atau kegagalan inisialisasi driver. Jika inisialisasi berhasil, ChangerClassInitialize mengembalikan STATUS_SUCCESS. Jika tidak, ChangerClassInitialize mengembalikan pesan kesalahan yang sesuai. Minidriver tidak boleh menginterpretasikan nilai kesalahan ini, tetapi harus mengembalikan nilai ini dari rutinitas DriverEntry mereka.
Keterangan
ChangerClassInitialize adalah rutinitas driver kelas pengubah yang dapat dipanggil driver miniclass di Microsoft Windows XP dan sistem operasi yang lebih baru.
Driver miniclass changer memanggil ChangerClassInitialize dari dalam rutinitas DriverEntry mereka untuk menginisialisasi driver. ChangerClassInitialize melakukan banyak tugas yang sebelumnya dilakukan oleh rutinitas DriverEntry driver kelas changer seperti mendaftarkan rutinitas pengiriman driver miniclass. Ini mengalokasikan ekstensi objek driver dan menyalin data yang terkandung dalam MCDInitData ke dalam ekstensi objek driver bersama dengan data inisialisasi lainnya seperti jalur registri driver dan penunjuk ke rutinitas driver kelas pengubah tertentu yang khusus untuk sistem operasi.
Driver miniclass changer harus mengalokasikan struktur MCD_INIT_DATA , nol struktur dengan memanggil RtlZeroMemory, lalu menetapkan nilai ke anggota yang sesuai, sebelum meneruskan alamat struktur ke ChangerClassInitialize melalui parameter MCDInitData .
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Target Platform | Desktop |
| Header | mcd.h (termasuk Mcd.h, Ntddchgr.h) |
| Pustaka | Mcd.lib |