PsSetLoadImageNotifyRoutine 関数 (ntddk.h)
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入手できます。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows 2000 以降で使用できます。 |
| 対象プラットフォーム | ユニバーサル |
| Header | ntddk.h (Ntddk.h を含む) |
| Library | NtosKrnl.lib |
| [DLL] | NtosKrnl.exe |
| IRQL | PASSIVE_LEVEL |
| DDI コンプライアンス規則 | HwStorPortProhibitedDDIs(storport), IrqlPsPassive(wdm), PowerIrpDDis(wdm) |
こちらもご覧ください
PsRemoveLoadImageNotifyRoutine