PsSetLoadImageNotifyRoutineEx, fonction (ntddk.h)

Article
02/07/2025

La routine PsSetLoadImageNotifyRoutineEx inscrit un rappel fourni par le pilote qui est ensuite averti chaque fois qu’une image (par exemple, une DLL ou UN EXE) est chargée (ou mappée en mémoire).

Syntaxe

NTSTATUS PsSetLoadImageNotifyRoutineEx(
  [in] PLOAD_IMAGE_NOTIFY_ROUTINE NotifyRoutine,
  [in] ULONG_PTR                  Flags
);

Paramètres

[in] NotifyRoutine

Pointeur vers la routine de rappel implémentée par l’appelant PLOAD_IMAGE_NOTIFY_ROUTINE pour les notifications d’image de charge.

[in] Flags

Fournit un masque de bits d’indicateurs qui contrôlent la fonction de rappel. Voici les valeurs possibles :

PS_IMAGE_NOTIFY_CONFLICTING_ARCHITECTURE indique que la routine de rappel doit être appelée pour toutes les images potentiellement exécutables, y compris les images qui ont une architecture différente de l’architecture native du système d’exploitation.

Valeur de retour

Retourner le code	Description
STATUS_SUCCESS	Le rappel a été correctement inscrit.
STATUS_INVALID_PARAMETER_2	L’indicateur non valide a été fourni dans indicateurs.
STATUS_INSUFFICIENT_RESOURCES	La routine a échoué à allouer un bloc de rappel en raison d’un manque de ressources.

Remarques

Les pilotes de profilage système de niveau supérieur peuvent appeler PsSetLoadImageNotifyRoutineEx pour configurer leurs routines de notification d’image de charge (voir PLOAD_IMAGE_NOTIFY_ROUTINE).

Le nombre maximal de pilotes pouvant être inscrits simultanément pour recevoir des notifications d’image de charge est de 64. Si le nombre maximal de routines d’notification d’image de charge est déjà inscrit lorsqu’un pilote appelle PsSetLoadImageNotifyRoutineEx pour essayer d’inscrire une routine d’notification supplémentaire, PsSetLoadImageNotifyRoutineEx échoue et retourne STATUS_INSUFFICIENT_RESOURCES.

Un pilote doit supprimer les rappels qu’il inscrit avant de décharger. Vous pouvez supprimer le rappel en appelant la routine PsRemoveLoadImageNotifyRoutine.

Exigences

Exigence	Valeur
client minimum pris en charge	Windows 10, version 1709
serveur minimum pris en charge	Windows Server 2016
plateforme cible	Windows
d’en-tête	ntddk.h
bibliothèque	NtosKrnl.lib
DLL	NtosKrnl.exe (mode noyau)
IRQL	PASSIVE_LEVEL

Partager via