PsSetLoadImageNotifyRoutine, fonction (ntddk.h)
Le PsSetLoadImageNotifyRoutine routine 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 PsSetLoadImageNotifyRoutine(
[in] PLOAD_IMAGE_NOTIFY_ROUTINE NotifyRoutine
);
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.
Valeur de retour
PsSetLoadImageNotifyRoutine retourne STATUS_SUCCESS ou retourne STATUS_INSUFFICIENT_RESOURCES en cas d’échec de l’inscription de rappel.
Remarques
Les pilotes de profilage système de niveau supérieur peuvent appeler PsSetLoadImageNotifyRoutine 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 huit. Si le nombre maximal de routines d’notification d’image de charge est déjà inscrit lorsqu’un pilote appelle PsSetLoadImageNotifyRoutine pour essayer d’inscrire une routine de notification supplémentaire, PsSetLoadImageNotifyRou tine échoue et retourne STATUS_INSUFFICIENT_RESOURCES.
notes
- Une mise à jour pour Windows 8.1 augmente le nombre maximal de pilotes inscrits pour recevoir des notifications d’image de charge de huit à 64. Cette mise à jour est installée dans le cadre d’une mise à jour cumulative disponible via Windows Update à compter du 8 avril 2014. En outre, cette mise à jour cumulative est disponible à https://support.microsoft.com/kb/2919355.
- Les utilisateurs de Windows 7 avec Service Pack 1 (SP1) peuvent installer un correctif logiciel pour augmenter le nombre maximal de pilotes inscrits pour recevoir des notifications d’image de charge comprises entre 8 et 64. Ce correctif logiciel est disponible à https://support.microsoft.com/kb/2922790.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Disponible à partir de Windows 2000. |
| plateforme cible | Universel |
| d’en-tête | ntddk.h (include Ntddk.h) |
| bibliothèque | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | PASSIVE_LEVEL |
| règles de conformité DDI | HwStorPortProhibitedDDIs(storport), IrqlPsPassive(wdm), PowerIrpDDis(wdm) |
Voir aussi
PsRemoveLoadImageNotifyRoutine