PsSetLoadImageNotifyRoutine-Funktion (ntddk.h)
Die PsSetLoadImageNotifyRoutine-Routine registriert einen vom Treiber bereitgestellten Rückruf, der anschließend benachrichtigt wird, wenn ein Bild (z. B. eine DLL oder EXE) geladen (oder dem Arbeitsspeicher zugeordnet wird).
Syntax
NTSTATUS PsSetLoadImageNotifyRoutine(
[in] PLOAD_IMAGE_NOTIFY_ROUTINE NotifyRoutine
);
Parameter
[in] NotifyRoutine
Ein Zeiger auf die vom Aufrufer implementierte PLOAD_IMAGE_NOTIFY_ROUTINE Rückrufroutine für Benachrichtigungen zum Laden von Images.
Rückgabewert
PsSetLoadImageNotifyRoutine gibt entweder STATUS_SUCCESS oder STATUS_INSUFFICIENT_RESOURCES zurück, wenn die Rückrufregistrierung fehlgeschlagen ist.
Hinweise
Systemprofiltreiber der obersten Ebene können PsSetLoadImageNotifyRoutine aufrufen, um ihre Benachrichtigungsroutinen für Ladeimages einzurichten (siehe PLOAD_IMAGE_NOTIFY_ROUTINE).
Die maximale Anzahl von Treibern, die gleichzeitig registriert werden können, um Benachrichtigungen zum Laden von Images zu empfangen, beträgt acht. Wenn die maximale Anzahl von Benachrichtigungsroutinen zum Laden von Images bereits registriert ist, wenn ein Treiber PsSetLoadImageNotifyRoutine aufruft, um eine zusätzliche Benachrichtigungsroutine zu registrieren, schlägt PsSetLoadImageNotifyRoutine fehl und gibt STATUS_INSUFFICIENT_RESOURCES zurück.
Hinweise
- Ein Update für Windows 8.1 erhöht die maximale Anzahl von Treibern, die zum Empfangen von Ladeimagebenachrichtigungen registriert sind, von acht auf 64. Dieses Update wird als Teil eines kumulativen Updates installiert, das ab dem 8. April 2014 über Windows Update verfügbar ist. Darüber hinaus ist dieses kumulative Update unter https://support.microsoft.com/kb/2919355verfügbar.
- Benutzer von Windows 7 mit Service Pack 1 (SP1) können einen Hotfix installieren, um die maximale Anzahl von Treibern zu erhöhen, die für den Empfang von Ladeimagebenachrichtigungen registriert sind, von 8 auf 64. Dieser Hotfix ist unter https://support.microsoft.com/kb/2922790verfügbar.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Verfügbar ab Windows 2000. |
| Zielplattform | Universell |
| Header | ntddk.h (include Ntddk.h) |
| Bibliothek | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | PASSIVE_LEVEL |
| DDI-Complianceregeln | HwStorPortProhibitedDIs(storport), IrqlPsPassive(wdm), PowerIrpDDis(wdm) |
Weitere Informationen
PsRemoveLoadImageNotifyRoutine