Condividi tramite

Funzione IoRegisterLastChanceShutdownNotification (wdm.h)

La routine IoRegisterLastChanceShutdownNotification registra un driver per ricevere un IRP IRP_MJ_SHUTDOWN quando il sistema viene arrestato, dopo che tutti i file system sono stati scaricati.

Sintassi

NTSTATUS IoRegisterLastChanceShutdownNotification(
  [in] PDEVICE_OBJECT DeviceObject
);

Parametri

[in] DeviceObject

Puntatore all'oggetto dispositivo del dispositivo per il quale il driver richiede la notifica di arresto. Il sistema passa questo puntatore alla routine DispatchShut down del driver.

Valore restituito

IoRegisterLastChanceShutdownNotification restituisce STATUS_SUCCESS in caso di esito positivo o il codice di errore NTSTATUS appropriato in caso di errore.

Osservazioni

La routine IoRegisterLastChanceShutdownNotification registra il driver per ricevere un IRP IRP_MJ_SHUTDOWN per il dispositivo specificato quando il sistema viene arrestato. Il driver riceve un tale IRP per ogni dispositivo per cui esegue la registrazione per la ricezione della notifica. I driver gestiscono IRP_MJ_SHUTDOWN IRP all'interno delle routine DispatchShutdown.

Per qualsiasi dispositivo registrato con questa routine, il sistema invia il IRP_MJ_SHUTDOWN IRP dopo lo scaricamento di tutti i file system. È necessario registrare un solo driver in uno stack di dispositivi per ricevere la notifica di arresto chiamando IoRegisterShutdownNotification o IoRegisterLastChanceShutdownNotification.

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.

Un driver che chiama IoRegisterLastChanceShutdownNotification deve soddisfare le restrizioni seguenti nella routine DispatchShutdown:

  • La routine DispatchShutdown non deve chiamare routine di paging.
  • La routine DispatchShutdown non deve accedere alla memoria pageable.
  • La routine dispatchshutdown non deve eseguire alcuna operazione di I/O di file.
La maggior parte dei driver che richiedono la notifica di arresto deve chiamare la routine IoRegisterShutdownNotification, che non impone queste limitazioni alla routine DispatchShutdown e che determina la chiamata della routine DispatchShutdown prima dello scaricamento dei file system. Solo i driver che devono eseguire alcune operazioni di pulizia dopo lo scaricamento dei file system, ad esempio un driver per un dispositivo di archiviazione di massa, devono usare IoRegisterLastChanceShutdownNotification.

La routine dispatchshutdown registrata viene chiamata prima che il risparmio energia invii una richiesta di IRP_MN_SET_POWER per PowerSystemShutdown. La routine dispatchshutdown non viene chiamata per le transizioni ad altri stati di alimentazione.

Fabbisogno

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 HwStorPortProhibitedDDIs(storport), PowerIrpDDis(wdm)

Vedere anche

DispatchShutdown

IoRegisterShutdownNotification

IoUnregisterShutdownNotification

  • Last updated on