KdBreakPoint function
The KdBreakPoint macro breaks into the kernel debugger.
Syntax
VOID NTAPI KdBreakPoint(void);
Parameters
This function has no parameters.
Return value
None
Remarks
KdBreakPoint is the kernel-mode equivalent of the DebugBreak routine. KdBreakPoint is identical to the DbgBreakPoint routine in code that is compiled for a debug configuration. It has no effect if compiled for a release configuration.
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 |
Desktop |
Header |
Ntddk.h (include Wdm.h or Ntddk.h) |
Library |
NtosKrnl.lib |
DLL |
NtosKrnl.exe |
See also