DbgBreakPointWithStatus - NtDoc
Native API online documentation, based on the System Informer
(formerly Process Hacker) phnt
headers
#ifndef _NTDBG_H
NTSYSAPI
VOID
NTAPI
DbgBreakPointWithStatus(
_In_ ULONG Status
);
View code on GitHub// wdm.h
__analysis_noreturn NTSYSAPI VOID DbgBreakPointWithStatus(
[in] ULONG Status
);
View the official Windows Driver Kit DDI referenceThis function is documented in Windows Driver Kit.
The DbgBreakPointWithStatus routine breaks into the kernel debugger and sends the value of Status to the debugger.
Status [in]Specifies a ULONG value that is sent to the debugger (for example, a status code or an address).
None
DbgBreakPointWithStatus is identical to DbgBreakPoint, except for the Status message.
On x86 computers, the Status parameter is stored in the eax register. On machines that have register calling conventions, Status is stored in the first argument register.
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.