Condividi tramite


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)

Vedi anche

DispatchShutdown

IoRegisterLastChanceShutdownNotification

IoUnregisterShutdownNotification