PsSetLoadImageNotifyRoutine, fonction (ntddk.h)

  • Article

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.
Un pilote doit supprimer les rappels qu’il enregistre avant de se décharger. Vous pouvez supprimer le rappel en appelant la routine PsRemoveLoadImageNotifyRoutine .

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

PLOAD_IMAGE_NOTIFY_ROUTINE

PsGetCurrentProcessId

PsRemoveLoadImageNotifyRoutine

PsSetCreateProcessNotifyRoutine

PsSetCreateThreadNotifyRoutine