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

Header

Ntddk.h (include Wdm.h or Ntddk.h)

Library

Ntoskrnl.lib

See also

DbgBreakPoint
DbgBreakPointWithStatus
KdBreakPointWithStatus

 

 

Send comments about this topic to Microsoft

Show:
© 2014 Microsoft. All rights reserved.