dbgBreakPointWithStatus 函数 (wdm.h)

DbgBreakPointWithStatus 例程会中断内核调试器,并将 Status 的值发送到调试器。

语法

__analysis_noreturn NTSYSAPI VOID DbgBreakPointWithStatus(
  [in] ULONG Status
);

参数

[in] Status

指定发送到调试器的 ULONG 值, (例如状态代码或) 地址。

返回值

备注

DbgBreakPointWithStatusDbgBreakPoint 相同, 状态消息除外

在 x86 计算机上, Status 参数存储在 eax 寄存器中。 在具有寄存器调用约定的计算机上, Status 存储在第一个参数寄存器中。

如果安装了内核调试程序,此例程将引发由内核调试器处理的异常;否则由调试系统处理。 如果调试器未连接到系统,则可以以标准方式处理异常。

在内核模式下,未处理的中断异常将导致 bug 检查。 但是,可以将内核模式调试器连接到已停止响应并启用了内核调试的目标计算机。 有关详细信息,请参阅 Windows 调试

要求

要求
最低受支持的客户端 在 Microsoft Windows 2000 及更高版本中可用。
目标平台 通用
标头 wdm.h (包括 Wdm.h、Ntddk.h)
Library Ntdll.lib (用户模式) ;NtosKrnl.lib (内核模式)
DLL NtosKrnl.exe
DDI 符合性规则 DebugBreakUsage (wdm) HwStorPortProhibitedDDI (storport)

另请参阅

DbgBreakPoint

KdBreakPoint

KdBreakPointWithStatus