KBUGCHECK_CALLBACK_ROUTINE回调函数 （wdm.h）
每当系统发出 bug 检查时，将执行 BugCheckCallback 例程。
KBUGCHECK_REASON_CALLBACK_ROUTINE 回调函数提供的功能比此旧回调多。
语法
KBUGCHECK_CALLBACK_ROUTINE KbugcheckCallbackRoutine;
void KbugcheckCallbackRoutine(
[in] IN PVOID Buffer,
[in] IN ULONG Length
)
{...}
参数
[in] Buffer
指向注册回调时指定的缓冲区的指针。
[in] Length
指定 Buffer 参数指向的缓冲区的长度（以字节为单位）。
返回值
没有
言论
驱动程序可以提供 BugCheckCallback，当系统发出 bug 检查时，可将设备重置为已知状态。
使用 KeRegisterBugCheckCallback 注册 BugCheckCallback 例程。 驱动程序随后可以使用 KeDeregisterBugCheckCallback 例程删除回调。 如果可以卸载驱动程序，则必须删除其 Unload 例程中的任何已注册回调。
BugCheckCallback 例程在可以执行的作中受到强烈限制。 有关详细信息，请参阅 编写 bug 检查回调例程。 例程可以安全地使用 READ_PORT_XXX、READ_REGISTER_XXX、WRITE_PORT_XXX，以及 WRITE_REGISTER_XXX 例程与设备交互。
需要与系统进行更复杂的交互的驱动程序，因为它发出 bug 检查可以改为实现 KbCallbackDumpIo 或 KbCallbackSecondaryDumpData 例程。
请注意，从 Windows XP SP1 和 Windows Server 2003作系统开始，BugCheckCallback 例程在系统故障转储文件写入后执行。 （在早期版本的 Windows 上，在写入故障转储文件之前执行例程。因此，存储在 Buffer 参数指定的缓冲区中的任何数据都不会显示在故障转储文件中。 将数据写入故障转储文件所需的驱动程序改为实现 KbCallbackSecondaryDumpData 例程。 （在早期版本的 Windows 上，写入 Buffer 的数据确实出现在故障转储文件中。
例子
若要定义 BugCheckCallback 回调例程，必须先提供一个函数声明来标识要定义的回调例程的类型。 Windows 为驱动程序提供一组回调函数类型。 使用回调函数类型声明函数有助于 驱动程序代码分析、静态驱动程序验证程序（SDV）和其他验证工具查找错误，这是为 Windows作系统编写驱动程序的要求。
例如，若要定义名为 MyBugCheckCallback的 BugCheckCallback 回调例程，请使用KBUGCHECK_CALLBACK_ROUTINE类型，如以下代码示例所示：
KBUGCHECK_CALLBACK_ROUTINE MyBugCheckCallback;
然后，按如下所示实现回调例程：
_Use_decl_annotations_
VOID
MyBugCheckCallback(
PVOID Buffer,
ULONG Length
)
{
// Function body
}
KBUGCHECK_CALLBACK_ROUTINE函数类型在 Wdm.h 头文件中定义。 若要在运行代码分析工具时更准确地识别错误，请务必将 Use_decl_annotations 注释添加到函数定义。 Use_decl_annotations 批注可确保使用应用于头文件中KBUGCHECK_CALLBACK_ROUTINE函数类型的批注。 有关函数声明要求的详细信息，请参阅 使用 WDM 驱动程序的函数角色类型来声明函数。 有关 Use_decl_annotations的信息，请参阅 批注函数行为。
要求
| 要求 | 价值 |
|---|---|
| 目标平台 | 桌面 |
| 标头 | wdm.h （包括 Wdm.h、Ntddk.h、Ntifs.h） |
| IRQL | 在HIGH_LEVEL调用。 |