DbgBreakPoint

DbgBreakPoint routine

The DbgBreakPoint routine breaks into the kernel debugger.

Syntax


VOID DbgBreakPoint(void);

Parameters

This routine 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

Ntddk.h (include Wdm.h or 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

 

 

Send comments about this topic to Microsoft

Show:
© 2016 Microsoft