DbgBreakPoint function

The DbgBreakPoint routine breaks into the kernel debugger.

Syntax

__analysis_noreturn VOID DbgBreakPoint(

);

Parameters

This function has no parameters.

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

   
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)

See Also

DbgBreakPointWithStatus

KdBreakPoint

KdBreakPointWithStatus