PsSetLoadImageNotifyRoutine, fonction (ntddk.h)
La routine PsSetLoadImageNotifyRoutine enregistre un rappel fourni par le pilote qui est ensuite notifié chaque fois qu’une image (par exemple, une DLL ou 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 retournée
PsSetLoadImageNotifyRoutine retourne STATUS_SUCCESS ou retourne STATUS_INSUFFICIENT_RESOURCES en cas d’échec de l’inscription du 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 de notification d’image de charge est déjà inscrit lorsqu’un pilote appelle PsSetLoadImageNotifyRoutine pour essayer d’inscrire une routine de notification supplémentaire, PsSetLoadImageNotifyRoutine échoue et retourne STATUS_INSUFFICIENT_RESOURCES.
Remarques
- 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 à l’adresse 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 de 8 à 64. Ce correctif logiciel est disponible à l’adresse https://support.microsoft.com/kb/2922790.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Disponible à partir de Windows 2000. |
| Plateforme cible | Universal |
| En-tête | ntddk.h (inclure 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