Función IoRegisterShutdownNotification (wdm.h)
La rutina IoRegisterShutdownNotification registra el controlador para recibir un IRP de IRP_MJ_SHUTDOWN cuando se apaga el sistema.
Sintaxis
NTSTATUS IoRegisterShutdownNotification(
[in] PDEVICE_OBJECT DeviceObject
);
Parámetros
[in] DeviceObject
Puntero al objeto de dispositivo del dispositivo para el que el controlador solicita la notificación de apagado. El sistema pasa este puntero a la rutina DispatchShutdown del controlador.
Valor devuelto
IoRegisterShutdownNotification devuelve STATUS_SUCCESS si se ejecuta correctamente o el código de error NTSTATUS adecuado en caso de error.
Comentarios
La rutina IoRegisterShutdownNotification registra el controlador para recibir un IRP de IRP_MJ_SHUTDOWN para el dispositivo especificado cuando el sistema se apaga. El controlador recibe uno de estos IRP para cada dispositivo para el que se registra para recibir notificaciones. Los controladores controlan IRP_MJ_SHUTDOWN IRP dentro de sus rutinas DispatchShutdown .
Si el controlador deja de requerir la notificación de apagado para el dispositivo, use IoUnregisterShutdownNotification para quitar el controlador de la cola de notificaciones de apagado.
Solo un controlador de una pila de dispositivos debe registrarse para recibir la notificación de apagado.
El sistema envía al controlador la solicitud IRP_MJ_SHUTDOWN antes de vaciar los sistemas de archivos. Algunos controladores, como los controladores para dispositivos de almacenamiento masivo, pueden requerir una notificación de apagado después de que el sistema vacíe los sistemas de archivos. Para recibir una notificación de apagado para un dispositivo después de vaciar los sistemas de archivos, use la rutina IoRegisterLastChanceShutdownNotification en su lugar.
Se llama a la rutina DispatchShutdown registrada antes de que el administrador de energía envíe una solicitud de IRP_MN_SET_POWER para PowerSystemShutdown. No se llama a la rutina DispatchShutdown para las transiciones a ningún otro estado de energía.
Un escritor de controladores no puede realizar suposiciones sobre el orden en que se llamará a la rutina DispatchShutdown del controlador en relación con otras rutinas de este tipo o con otras actividades de apagado.
Un controlador PnP puede registrar una rutina de apagado para realizar determinadas tareas antes de que se inicie el apagado del sistema, como el código de bloqueo.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Disponible en Windows 2000 y versiones posteriores de Windows. No está disponible en Microsoft Windows 98/Me. |
| Plataforma de destino | Universal |
| Encabezado | wdm.h (incluya Wdm.h, Ntddk.h, Ntifs.h) |
| Library | NtosKrnl.lib |
| Archivo DLL | NtosKrnl.exe |
| IRQL | PASSIVE_LEVEL |
| Reglas de cumplimiento de DDI | HwStorPortProhibitedDDIs(storport), IrqlIoPassive5(wdm), PowerIrpDDis(wdm) |