WdfVerifierKeBugCheck 函数 (wdfverifier.h)
[适用于 KMDF 和 UMDF]
WdfVerifierKeBugCheck 函数检查创建 bug。
语法
void WdfVerifierKeBugCheck(
[in] ULONG BugCheckCode,
[in] ULONG_PTR BugCheckParameter1,
[in] ULONG_PTR BugCheckParameter2,
[in] ULONG_PTR BugCheckParameter3,
[in] ULONG_PTR BugCheckParameter4
);
参数
[in] BugCheckCode
bug 之一检查Bugcodes.h 中定义的代码。
[in] BugCheckParameter1
有关此参数的信息,请参阅指定的 bug 检查代码的说明。
[in] BugCheckParameter2
有关此参数的信息,请参阅指定的 bug 检查代码的说明。
[in] BugCheckParameter3
有关此参数的信息,请参阅指定的 bug 检查代码的说明。
[in] BugCheckParameter4
有关此参数的信息,请参阅指定的 bug 检查代码的说明。
返回值
无
备注
如果 Kernel-Mode 驱动程序框架 (KMDF) 驱动程序调用 WdfVerifierKeBugCheck,操作系统将停止并显示 蓝屏 ,除非 调试器 正在运行。
如果 User-Mode 驱动程序框架 (UMDF) 驱动程序 (版本 2.0 或更高版本) 调用 WdfVerifierKeBugCheck,则框架不使用驱动程序提供的参数。 在这种情况下,如果已连接,框架会中断到调试器中。 如果未连接调试器,框架将生成异常,默认 UMDF 异常处理程序将创建一个小型转储文件。 有关驱动程序主机进程中未经处理的异常的详细信息,请参阅 UMDF 如何报告错误。
有关调试驱动程序的详细信息,请参阅 调试 WDF 驱动程序。
示例
下面的代码示例创建一个 bug 检查,该 bug 使用 MULTIPLE_IRP_COMPLETE_REQUESTS bug 检查 代码。
WdfVerifierKeBugCheck(
MULTIPLE_IRP_COMPLETE_REQUESTS,
(ULONG_PTR) irp,
(ULONG_PTR) srb,
0,
0
);
要求
要求 | 值 |
---|---|
目标平台 | 通用 |
最低 KMDF 版本 | 1.0 |
最低 UMDF 版本 | 2.0 |
标头 | wdfverifier.h (包括 Wdf.h) |
Library | Wdf01000.sys (KMDF) ;WUDFx02000.dll (UMDF) |
IRQL | 任何级别 |
DDI 符合性规则 | DriverCreate (kmdf) |
另请参阅
反馈
https://aka.ms/ContentUserFeedback。
即将发布:在整个 2024 年,我们将逐步淘汰作为内容反馈机制的“GitHub 问题”,并将其取代为新的反馈系统。 有关详细信息,请参阅:提交和查看相关反馈