WdfVerifierDbgBreakPoint 函数 (wdfverifier.h)

  • 项目

[适用于 KMDF 和 UMDF]

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

语法

void WdfVerifierDbgBreakPoint();

返回值

无

备注

如果存在以下任一条件， 则 WdfVerifierDbgBreakPoint 函数会中断到内核调试器中：

  • 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)
Library Wdf01000.sys (KMDF) ;WUDFx02000.dll (UMDF)
IRQL 任何级别
DDI 符合性规则 DriverCreate (kmdf)

另请参阅

WdfVerifierKeBugCheck