通过

WdfVerifierDbgBreakPoint 函数 （wdfverifier.h）

  • 项目

[适用于 KMDF 和 UMDF]

如果调试器正在运行，则 WdfVerifierDbgBreakPoint 函数中断到内核调试器中。

语法

void WdfVerifierDbgBreakPoint();

返回值

没有

言论

WdfVerifierDbgBreakPoint 函数在以下情况之一为 true 时闯入内核调试器：

  • DbgBreakOnError 设置为注册表中的非零值。
  • VerifierOn 设置为非零值，并且未设置 dbgBreakOnError 。
  • 驱动程序验证程序已启用，驱动程序是使用框架版本 1.9 或更高版本生成的，并且未设置 VerifierOn 也不 DbgBreakOnError。
有关可用于调试驱动程序的注册表项的详细信息，请参阅 用于调试 Framework-Based 驱动程序的注册表项。

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

例子

下面的代码示例演示驱动程序如何处理无法获取 I/O 请求的输出缓冲区。

Status = WdfRequestRetrieveOutputMemory(
                                        Request,
                                        &memory
                                        );
if( !NT_SUCCESS(Status) ) {
    KdPrint(("EvtIoRead could not get request memory buffer. Status: 0x%x\n",Status));
    WdfVerifierDbgBreakPoint();
    WdfRequestCompleteWithInformation(
                                      Request,
                                      Status,
                                      0L
                                      );
    return;
}

要求

要求 价值
目标平台 普遍
最低 KMDF 版本 1.0
最低 UMDF 版本 2.0
标头 wdfverifier.h （包括 Wdf.h）
库 Wdf01000.sys（KMDF）：WUDFx02000.dll （UMDF）
IRQL 任何级别
DDI 符合性规则 DriverCreate（kmdf）

另请参阅

WdfVerifierKeBugCheck