Funzione IoRegisterShutdownNotification (wdm.h)
La routine IoRegisterShutdownNotification registra il driver per ricevere una IRP_MJ_SHUTDOWN IRP quando il sistema viene arrestato.
Sintassi
NTSTATUS IoRegisterShutdownNotification(
[in] PDEVICE_OBJECT DeviceObject
);
Parametri
[in] DeviceObject
Puntatore all'oggetto dispositivo del dispositivo per cui il driver richiede la notifica di arresto. Il sistema passa questo puntatore alla routine DispatchShutdown del driver.
Valore restituito
IoRegisterShutdownNotification restituisce STATUS_SUCCESS sull'esito positivo o sul codice di errore NTSTATUS appropriato in caso di errore.
Commenti
La routine IoRegisterShutdownNotification registra il driver per ricevere un IRP_MJ_SHUTDOWN IRP per il dispositivo specificato quando il sistema viene arrestato. Il driver riceve un'IRP di questo tipo per ogni dispositivo che registra per ricevere la notifica. I driver gestiscono IRP_MJ_SHUTDOWN IRP all'interno delle routine DispatchShutdown .
Se il driver smette di richiedere la notifica di arresto per il dispositivo, usare IoUnregisterShutdownNotification per rimuovere il driver dalla coda di notifica di arresto.
È necessario registrare un solo driver in uno stack di dispositivi per ricevere una notifica di arresto.
Il sistema invia il driver alla richiesta di IRP_MJ_SHUTDOWN prima di scaricare i file system. Alcuni driver, ad esempio i driver per i dispositivi di archiviazione di massa, possono richiedere una notifica di arresto dopo che il sistema scarica i file system. Per ricevere una notifica di arresto per un dispositivo dopo che i file system vengono scaricati, usare invece la routine IoRegisterLastChanceShutdownNotification .
La routine DispatchShutdown registrata viene chiamata prima che il power manager invii una richiesta di IRP_MN_SET_POWER per PowerSystemShutdown. La routine DispatchShutdown non viene chiamata per le transizioni ad altri stati di alimentazione.
Un writer di driver non può fare ipotesi sull'ordine in cui verrà chiamata la routine DispatchShutdown del driver in relazione ad altre routine o ad altre attività di arresto.
Un driver PnP potrebbe registrare una routine di arresto per eseguire determinate attività prima dell'avvio dell'arresto del sistema, ad esempio il blocco del codice.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Disponibile in Windows 2000 e versioni successive di Windows. Non disponibile in Microsoft Windows 98/Me. |
| Piattaforma di destinazione | Universale |
| Intestazione | wdm.h (include Wdm.h, Ntddk.h, Ntifs.h) |
| Libreria | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | PASSIVE_LEVEL |
| Regole di conformità DDI | HwStorPortProhibitedDDDIs(storport), IrqlIoPassive5(wdm), PowerIrpDDis(wdm) |