Funzione PsSetLoadImageNotifyRoutine (ntddk.h)
La routine PsSetLoadImageNotifyRoutine registra un callback fornito dal driver che viene successivamente informato ogni volta che un'immagine (ad esempio, una DLL o un file EXE) viene caricata (o mappata in memoria).
Sintassi
NTSTATUS PsSetLoadImageNotifyRoutine(
[in] PLOAD_IMAGE_NOTIFY_ROUTINE NotifyRoutine
);
Parametri
[in] NotifyRoutine
Puntatore alla routine di callback implementata dal chiamante PLOAD_IMAGE_NOTIFY_ROUTINE per le notifiche di immagine di caricamento.
Valore restituito
PsSetLoadImageNotifyRoutine restituisce STATUS_SUCCESS oppure restituisce STATUS_INSUFFICIENT_RESOURCES se non è riuscita la registrazione del callback.
Osservazioni
I driver di profilatura di sistema di livello più elevato possono chiamare PsSetLoadImageNotifyRoutine per configurare le routine di notifica dell'immagine di caricamento (vedere PLOAD_IMAGE_NOTIFY_ROUTINE).
Il numero massimo di driver che possono essere registrati contemporaneamente per ricevere notifiche di immagine di caricamento è otto. Se il numero massimo di routine di notifica dell'immagine di caricamento è già registrato quando un driver chiama PsSetLoadImageNotifyRoutine di provare a registrare una routine di notifica aggiuntiva, PsSetLoadImageNotifyRoutine ha esito negativo e restituisce STATUS_INSUFFICIENT_RESOURCES.
Note
- Un aggiornamento per Windows 8.1 aumenta il numero massimo di driver registrati per ricevere notifiche di immagine di caricamento da otto a 64. Questo aggiornamento viene installato come parte di un aggiornamento cumulativo disponibile tramite Windows Update a partire dall'8 aprile 2014. Inoltre, questo aggiornamento cumulativo è disponibile in https://support.microsoft.com/kb/2919355.
- Gli utenti di Windows 7 con Service Pack 1 (SP1) possono installare un hotfix per aumentare il numero massimo di driver registrati per ricevere notifiche di immagine di caricamento da 8 a 64. Questo hotfix è disponibile in https://support.microsoft.com/kb/2922790.
Fabbisogno
| Requisito | Valore |
|---|---|
| client minimo supportato | Disponibile a partire da Windows 2000. |
| piattaforma di destinazione | Universale |
| intestazione | ntddk.h (include Ntddk.h) |
| libreria | NtosKrnl.lib |
| dll | NtosKrnl.exe |
| IRQL | PASSIVE_LEVEL |
| regole di conformità DDI | HwStorPortProhibitedDDIs(storport), IrqlPsPassive(wdm), PowerIrpDDis(wdm) |
Vedere anche
PsRemoveLoadImageNotifyRoutine