Edit

DbgBreakPoint function (wdm.h)

  • Article

The DbgBreakPoint routine breaks into the kernel debugger.

Syntax

__analysis_noreturn VOID DbgBreakPoint();

Return value

None

Remarks

The DbgBreakPoint routine is the kernel-mode equivalent of DebugBreak.

This routine raises an exception that is handled by the kernel debugger if one is installed; otherwise, it is handled by the debug system. If a debugger is not connected to the system, the exception can be handled in the standard way.

In kernel mode, a break exception that is not handled will cause a bug check. You can, however, connect a kernel-mode debugger to a target computer that has stopped responding and has kernel debugging enabled. For more information, see Windows Debugging.

Requirements

Requirement Value
Target Platform Universal
Header wdm.h (include Wdm.h, Ntddk.h)
Library NtDll.lib (user mode); NtosKrnl.lib (kernel mode)
DLL NtDll.dll (user mode); NtosKrnl.exe (kernel mode)
DDI compliance rules HwStorPortProhibitedDDIs(storport)

See also

DbgBreakPointWithStatus

KdBreakPoint

KdBreakPointWithStatus