Funzione PsSetLoadImageNotifyRoutine (ntddk.h)

  • Articolo

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.
Un driver deve rimuovere tutti i callback registrati prima dello scaricamento. È possibile rimuovere il callback chiamando la routine PsRemoveLoadImageNotifyRoutine .

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

PLOAD_IMAGE_NOTIFY_ROUTINE

PsGetCurrentProcessId

PsRemoveLoadImageNotifyRoutine

PsSetCreateProcessNotifyRoutine

PsSetCreateThreadNotifyRoutine