PsSetLoadImageNotifyRoutine-Funktion (ntddk.h)

  • Artikel

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.
Ein Treiber muss alle Rückrufe entfernen, die er registriert, bevor er entladen wird. Sie können den Rückruf entfernen, indem Sie die PsRemoveLoadImageNotifyRoutine-Routine aufrufen.

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

PLOAD_IMAGE_NOTIFY_ROUTINE

PsGetCurrentProcessId

PsRemoveLoadImageNotifyRoutine

PsSetCreateProcessNotifyRoutine

PsSetCreateThreadNotifyRoutine