PsSetLoadImageNotifyRoutine 関数 (ntddk.h)

[アーティクル]
08/07/2023

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) のユーザーは、修正プログラムをインストールして、読み込みイメージ通知を受け取るために登録されているドライバーの最大数を 8 から 64 に増やすことができます。この修正プログラムは、で https://support.microsoft.com/kb/2922790入手できます。

ドライバーは、アンロードする前に登録されているコールバックを削除する必要があります。コールバックを削除するには、 PsRemoveLoadImageNotifyRoutine ルーチンを呼び出します。

要件

要件	値
サポートされている最小のクライアント	Windows 2000 以降で使用できます。
対象プラットフォーム	ユニバーサル
Header	ntddk.h (Ntddk.h を含む)
Library	NtosKrnl.lib
[DLL]	NtosKrnl.exe
IRQL	PASSIVE_LEVEL
DDI コンプライアンス規則	HwStorPortProhibitedDDIs(storport), IrqlPsPassive(wdm), PowerIrpDDis(wdm)