Función PsSetLoadImageNotifyRoutine (ntddk.h)

  • Artículo

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.
Un controlador debe quitar las devoluciones de llamada que registre antes de descargarla. Puede quitar la devolución de llamada llamando a la rutina PsRemoveLoadImageNotifyRoutine .

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

PLOAD_IMAGE_NOTIFY_ROUTINE

PsGetCurrentProcessId

PsRemoveLoadImageNotifyRoutine

PsSetCreateProcessNotifyRoutine

PsSetCreateThreadNotifyRoutine