Auf Englisch lesen

Freigeben über


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 im Speicher zugeordnet ist).

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 Ladebildbenachrichtigungen.

Rückgabewert

PsSetLoadImageNotifyRoutine gibt entweder STATUS_SUCCESS zurück oder gibt STATUS_INSUFFICIENT_RESOURCES zurück, wenn die Rückrufregistrierung fehlgeschlagen ist.

Bemerkungen

Systemprofiltreiber auf höchster Ebene können PsSetLoadImageNotifyRoutine- aufrufen, um ihre Ladeimagebenachrichtigungsroutinen einzurichten (siehe PLOAD_IMAGE_NOTIFY_ROUTINE).

Die maximale Anzahl von Treibern, die gleichzeitig registriert werden können, um Ladeimagebenachrichtigungen zu empfangen, beträgt acht. Wenn die maximale Anzahl von Ladeimagebenachrichtigungsroutinen bereits registriert ist, wenn ein Treiber PsSetLoadImageNotifyRoutine aufruft, um zu versuchen, eine zusätzliche Benachrichtigungsroutine zu registrieren, PsSetLoadImageNotifyRou tine fehlschlägt und STATUS_INSUFFICIENT_RESOURCES zurückgibt.

Notizen-

  • Ein Update für Windows 8.1 erhöht die maximale Anzahl von Treibern, die registriert wurden, um Ladeimagebenachrichtigungen von acht auf 64 zu erhalten. 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 registriert sind, um Ladeimagebenachrichtigungen von 8 auf 64 zu erhalten. 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
mindestens unterstützte Client- Ab Windows 2000 verfügbar.
Zielplattform- Universal
Header- ntddk.h (include Ntddk.h)
Library NtosKrnl.lib
DLL- NtosKrnl.exe
IRQL- PASSIVE_LEVEL
DDI-Complianceregeln HwStorPortProhibitedDIs(storport), IrqlPsPassive(wdm), PowerIrpDDis(wdm)

Siehe auch

PLOAD_IMAGE_NOTIFY_ROUTINE

PsGetCurrentProcessId

PsRemoveLoadImageNotifyRoutine

PsSetCreateProcessNotifyRoutine

PsSetCreateThreadNotifyRoutine