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 以降で使用できます。 |
ターゲット プラットフォーム の | 万国 |
ヘッダー | ntddk.h (Ntddk.h を含む) |
ライブラリ | NtosKrnl.lib |
DLL | NtosKrnl.exe |
IRQL | PASSIVE_LEVEL |