PsSetLoadImageNotifyRoutine 函式（ntddk.h）

發行項
02/07/2025

PsSetLoadImageNotifyRoutine 例程會註冊驅動程式提供的回呼，該回呼會在每當載入映像（例如 DLL 或 EXE）時收到通知（或對應至記憶體）。

語法

NTSTATUS PsSetLoadImageNotifyRoutine(
  [in] PLOAD_IMAGE_NOTIFY_ROUTINE NotifyRoutine
);

參數

[in] NotifyRoutine

載入映像通知之呼叫端實作 PLOAD_IMAGE_NOTIFY_ROUTINE 回呼例程的指標。

傳回值

PsSetLoadImageNotifyRoutine 會傳回STATUS_SUCCESS，或者如果回呼註冊失敗，則會傳回STATUS_INSUFFICIENT_RESOURCES。

言論

最高層級的系統分析驅動程式可以呼叫 PsSetLoadImageNotifyRoutine 來設定其載入映射通知例程（請參閱 PLOAD_IMAGE_NOTIFY_ROUTINE）。

可以同時註冊以接收負載映像通知的驅動程式數目上限為8。如果驅動程式呼叫 PsSetLoadImageNotifyRoutine 嘗試註冊其他通知例程時，已註冊載載映射通知例程的最大數目，PsSetLoadImageNotifyRoutine 失敗並傳回STATUS_INSUFFICIENT_RESOURCES。

附注

Windows 8.1 的更新會增加註冊以接收 8 到 64 個負載映射通知的驅動程式數目上限。此更新會安裝為從 2014 年 4 月 8 日起透過 Windows Update 提供的累積更新的一部分。此外，此累積更新可在 https://support.microsoft.com/kb/2919355取得。
Windows 7 Service Pack 1（SP1）的使用者可以安裝 Hotfix，以增加註冊以接收 8 到 64 個負載映射通知的驅動程式數目上限。此 Hotfix 可在 https://support.microsoft.com/kb/2922790取得。

驅動程式必須先移除它註冊的任何回呼，才能卸除。您可以呼叫 PsRemoveLoadImageNotifyRoutine 例程來移除回呼。

要求

要求	價值
最低支援的用戶端	從 Windows 2000 開始提供。
目標平臺	普遍
標頭	ntddk.h （包括 Ntddk.h）
連結庫	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	PASSIVE_LEVEL
DDI 合規性規則	HwStorPortProhibitedDIs（storport），IrqlPsPassive（wdm），PowerIrpDDis（wdm）