Fungsi IoRegisterDriverReinitialization (ntddk.h)

  • Artikel

Rutinitas IoRegisterDriverReinitialization dipanggil oleh driver selama inisialisasi atau reinisialisasinya untuk mendaftarkan kembali rutinitasnya untuk dipanggil lagi sebelum driver dan, mungkin inisialisasi sistem selesai.

Sintaks

void IoRegisterDriverReinitialization(
  [in]           PDRIVER_OBJECT       DriverObject,
  [in]           PDRIVER_REINITIALIZE DriverReinitializationRoutine,
  [in, optional] PVOID                Context
);

Parameter

[in] DriverObject

Penunjuk ke objek driver yang dimasukkan ke rutinitas DriverEntry .

[in] DriverReinitializationRoutine

Arahkan ke rutinitas reinisialisasi pengemudi.

[in, optional] Context

Arahkan ke konteks yang akan diteruskan ke rutinitas Reinitialize driver.

Nilai kembali

Tidak ada

Keterangan

Driver dapat memanggil rutinitas ini hanya jika rutinitas DriverEntry-nya akan kembali STATUS_SUCCESS. Jika rutinitas Reinitialize yang disediakan driver harus menggunakan registri, rutinitas DriverEntry harus menyertakan salinan string yang ditujukan RegistryPath sebagai bagian dari konteks yang diteruskan ke rutinitas Reinitialize dalam panggilan ini.

Jika driver dimuat secara dinamis, dimungkinkan untuk ini terjadi selama sistem yang berjalan secara normal, sehingga semua referensi ke antrean reinisialisasi harus disinkronkan.

Input Count ke DriverReinitializationRoutine menunjukkan berapa kali rutinitas ini telah dipanggil, termasuk panggilan saat ini.

Rutinitas DriverEntry hanya dapat memanggil IoRegisterDriverReinitialization sekali. Jika rutinitas Reinisialisasi harus dijalankan lagi setelah rutinitas Reinisialisasi driver lain mengembalikan kontrol, rutinitas Reinisialisasi juga dapat memanggil IoRegisterDriverReinitialization sebanyak rutinitas Reinisialisasi driver harus dijalankan.

Biasanya, driver dengan rutinitas Reinitialize adalah driver tingkat lebih tinggi yang mengontrol perangkat PnP dan warisan. Driver tersebut tidak hanya boleh membuat objek perangkat untuk perangkat yang dideteksi manajer PnP (dan yang manajer PnP memanggil rutinitas AddDevice driver), driver juga harus membuat objek perangkat untuk perangkat warisan yang tidak dideteksi oleh manajer PnP. Driver dapat menggunakan rutinitas Menginisialisasi Ulang untuk membuat objek perangkat tersebut dan melapisi driver di atas driver yang lebih rendah berikutnya untuk perangkat yang mendasar.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Tersedia dimulai dengan Windows 2000.
Target Platform Universal
Header ntddk.h (termasuk Ntddk.h)
Pustaka NtosKrnl.lib
DLL NtosKrnl.exe
IRQL PASSIVE_LEVEL
Aturan kepatuhan DDI HwStorPortProhibitedDDIs(storport), IrqlIoPassive5(wdm), PowerIrpDDis(wdm)

Lihat juga

DRIVER_OBJECT

IoRegisterBootDriverReinitialization