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)

另请参阅

WdfVerifierDbgBreakPoint