Fungsi IoRegisterBootDriverReinitialization (ntddk.h)

  • Artikel

Rutinitas IoRegisterBootDriverReinitialization dipanggil oleh driver boot untuk mendaftarkan rutinitas reinisialisasi driver dengan manajer I/O untuk dipanggil setelah semua perangkat dijumlahkan dan dimulai.

Sintaks

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

Parameter

[in] DriverObject

Penunjuk ke objek driver untuk driver boot yang akan diinisialisasi ulang.

[in] DriverReinitializationRoutine

Arahkan ke rutinitas reinisialisasi driver.

[in, optional] Context

Penunjuk konteks opsional untuk diteruskan ke rutinitas reinisialisasi driver.

Nilai kembali

Tidak ada

Keterangan

Driver boot biasanya memanggil IoRegisterBootDriverReinitialization dari rutinitas DriverEntry-nya , yang dijalankan selama inisialisasi driver boot. IoRegisterBootDriverReinitialization mendaftarkan rutinitas panggilan balik reinisialisasi driver untuk dipanggil oleh manajer I/O setelah semua perangkat dijumlahkan dan dimulai. DriverReinitializationRoutine dijalankan dalam utas sistem di IRQL = PASSIVE_LEVEL.

Driver harus memanggil IoRegisterBootDriverReinitialization hanya jika rutinitas DriverEntry-nya akan mengembalikan STATUS_SUCCESS.

Jika DriverReinitializationRoutine menggunakan registri, rutinitas DriverEntry harus disertakan dalam parameter KonteksIoRegisterBootDriverReinitialization salinan string tempat parameter RegistryPathDriverEntry sendiri menunjuk.

Rutinitas DriverEntry hanya dapat memanggil IoRegisterBootDriverReinitialization sekali. Jika rutinitas reinitialisasi perlu dijalankan lebih dari sekali, DriverReinitializationRoutine dapat memanggil IoRegisterBootDriverReinitialization sebanyak yang diperlukan, menggunakan parameter Count untuk melacak berapa kali DriverReinitializationRoutine telah dipanggil.

Persyaratan

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

Lihat juga

DRIVER_OBJECT

IoRegisterDriverReinitialization

Reinitialize