通过

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

Bugcodes.h中定义的 bug 检查代码之一。

[in] BugCheckParameter1

有关此参数的信息，请参阅指定的 bug 检查代码的说明。

[in] BugCheckParameter2

有关此参数的信息，请参阅指定的 bug 检查代码的说明。

[in] BugCheckParameter3

有关此参数的信息，请参阅指定的 bug 检查代码的说明。

[in] BugCheckParameter4

有关此参数的信息，请参阅指定的 bug 检查代码的说明。

返回值

没有

言论

如果 Kernel-Mode 驱动程序框架（KMDF）驱动程序调用 WdfVerifierKeBugCheck，则操作系统将停止并显示 蓝屏，除非调试器正在运行。 有关详细信息，请参阅 WinDbg - 内核模式入门。

如果 User-Mode 驱动程序框架（UMDF）驱动程序（版本 2.0 或更高版本）调用 WdfVerifierKeBugCheck，则框架不使用驱动程序提供的参数。 在这种情况下，如果已连接框架，框架会中断调试器。 如果未连接调试器，框架将生成异常，并且默认的 UMDF 异常处理程序将创建一个小型转储文件。 有关驱动程序主机进程中未经处理的异常的详细信息，请参阅 UMDF 如何报告错误。

有关调试驱动程序的详细信息，请参阅 调试 WDF 驱动程序。

例子

下面的代码示例创建一个 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）
库 Wdf01000.sys（KMDF）：WUDFx02000.dll （UMDF）
IRQL 任何级别
DDI 符合性规则 DriverCreate（kmdf）

另请参阅

WdfVerifierDbgBreakPoint