IoRegisterBootDriverCallback 関数 (ntddk.h)
IoRegisterBootDriverCallback ルーチンは、ブートスタート ドライバーとその依存 DLL の初期化中に呼び出されるBOOT_DRIVER_CALLBACK_FUNCTION ルーチンを登録します。
構文
PVOID IoRegisterBootDriverCallback(
[in] PBOOT_DRIVER_CALLBACK_FUNCTION CallbackFunction,
[in, optional] PVOID CallbackContext
);
パラメーター
[in] CallbackFunction
ブートスタート ドライバーまたは DLL を初期化するときに呼び出される BOOT_DRIVER_CALLBACK_FUNCTION ルーチンへのポインター。
[in, optional] CallbackContext
CallbackFunction が指すBOOT_DRIVER_CALLBACK_FUNCTION ルーチンに渡されるドライバー定義コンテキスト。
戻り値
登録を表すハンドル。 このハンドルは、BOOT_DRIVER_CALLBACK_FUNCTION ルーチンの登録を解除する IoUnRegisterBootDriverCallback ルーチンの呼び出しで入力パラメーターとして指定する必要があります。
注釈
ブート開始ドライバーは 、IoUnRegisterBootDriverCallback を呼び出し、返されたハンドルを渡して、Windows がアンロードする前にブート開始ドライバー コールバックの登録を解除する必要があります。
状態更新コールバックから返されたエラーは致命的なものとして扱われ、システムバグチェックが発生します。 さらに、イメージの初期化コールバックがエラーを返す場合、ドライバーのイメージは不明として扱われます。 ブート開始ドライバーの初期化操作の通知を受け取るために、 早期起動マルウェア対策 (ELAM) ドライバーは IoRegisterBootDriverCallback を呼び出して 、BOOT_DRIVER_CALLBACK_FUNCTION ルーチンを登録できます。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows 8 以降で使用できます。 |
| 対象プラットフォーム | ユニバーサル |
| Header | ntddk.h (Ntddk.h を含む) |
| Library | NtosKrnl.lib |
| [DLL] | NtosKrnl.exe |
| IRQL | PASSIVE_LEVEL |