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

こちらもご覧ください

BDCB_CALLBACK_TYPE

BDCB_IMAGE_INFORMATION

IoUnRegisterBootDriverCallback