|
|
|
KdBreakPoint breaks into the kernel debugger.
VOID
NTAPI
KdBreakPoint(
VOID
);
This routine is defined in ntddk.h and wdm.h. Include ntddk.h or wdm.h.
This routine can only be used in Windows 2000 and later.
The KdBreakPoint routine is the kernel-mode equivalent of DebugBreak. KdBreakPoint is identical to DbgBreakPoint in code that is compiled in a checked build environment. It has no effect if compiled in a free build environment.
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 no debugger is 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 blue screen (bug check) to result. You can, however, connect a kernel-mode debugger to a hung target computer that has kernel debugging enabled. For more information, see Debugging Tools for NT-Based Operating Systems.
DbgBreakPoint, DbgBreakPointWithStatus, KdBreakPointWithStatus