Funzione PsSetLoadImageNotifyRoutine (ntddk.h)
La routine PsSetLoadImageNotifyRoutine registra un callback fornito dal driver che riceve successivamente una notifica ogni volta che viene caricata un'immagine (ad esempio, una DLL o exe) (o mappata in memoria).
Sintassi
NTSTATUS PsSetLoadImageNotifyRoutine(
[in] PLOAD_IMAGE_NOTIFY_ROUTINE NotifyRoutine
);
Parametri
[in] NotifyRoutine
Puntatore al chiamante implementato PLOAD_IMAGE_NOTIFY_ROUTINE routine di callback per le notifiche di load-image.
Valore restituito
PsSetLoadImageNotifyRoutine restituisce STATUS_SUCCESS oppure restituisce STATUS_INSUFFICIENT_RESOURCES se non è riuscita la registrazione di callback.
Commenti
I driver di profilatura di sistema di livello più alto 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 simultaneamente 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 per 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 all'indirizzo 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 all'indirizzo https://support.microsoft.com/kb/2922790.
Requisiti
| 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) |
Vedi anche
PsRemoveLoadImageNotifyRoutine