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

See also

DbgBreakPoint

DbgBreakPointWithStatus

KdBreakPointWithStatus

Send comments about this topic to Microsoft