Función PsSetLoadImageNotifyRoutine (ntddk.h)
La rutina PsSetLoadImageNotifyRoutine registra una devolución de llamada proporcionada por el controlador que se notifica posteriormente cada vez que se carga una imagen (por ejemplo, un archivo DLL o EXE) (o se asigna a la memoria).
Sintaxis
NTSTATUS PsSetLoadImageNotifyRoutine(
[in] PLOAD_IMAGE_NOTIFY_ROUTINE NotifyRoutine
);
Parámetros
[in] NotifyRoutine
Puntero a la rutina de devolución de llamada implementada por el autor de la llamada PLOAD_IMAGE_NOTIFY_ROUTINE para las notificaciones de imagen de carga.
Valor devuelto
PsSetLoadImageNotifyRoutine devuelve STATUS_SUCCESS o devuelve STATUS_INSUFFICIENT_RESOURCES si se produjo un error en el registro de devolución de llamada.
Comentarios
Los controladores de generación de perfiles del sistema de nivel más alto pueden llamar a PsSetLoadImageNotifyRoutine para configurar sus rutinas de notificación de imagen de carga (consulte PLOAD_IMAGE_NOTIFY_ROUTINE).
El número máximo de controladores que se pueden registrar simultáneamente para recibir notificaciones de imagen de carga es ocho. Si el número máximo de rutinas de notificación de imagen de carga ya está registrado cuando un controlador llama a PsSetLoadImageNotifyRoutine para intentar registrar una rutina de notificación adicional, PsSetLoadImageNotifyRoutine produce un error y devuelve STATUS_INSUFFICIENT_RESOURCES.
Notas
- Una actualización de Windows 8.1 aumenta el número máximo de controladores registrados para recibir notificaciones de imagen de carga de ocho a 64. Esta actualización se instala como parte de una actualización acumulativa que está disponible a través de Windows Update a partir del 8 de abril de 2014. Además, esta actualización acumulativa está disponible en https://support.microsoft.com/kb/2919355.
- Los usuarios de Windows 7 con Service Pack 1 (SP1) pueden instalar una revisión para aumentar el número máximo de controladores registrados para recibir notificaciones de imagen de carga de 8 a 64. Esta revisión está disponible en https://support.microsoft.com/kb/2922790.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Disponible a partir de Windows 2000. |
| Plataforma de destino | Universal |
| Encabezado | ntddk.h (incluya Ntddk.h) |
| Library | NtosKrnl.lib |
| Archivo DLL | NtosKrnl.exe |
| IRQL | PASSIVE_LEVEL |
| Reglas de cumplimiento de DDI | HwStorPortProhibitedDIs(storport), IrqlPsPassive(wdm), PowerIrpDDis(wdm) |
Consulte también
PsRemoveLoadImageNotifyRoutine