Función DbgBreakPointWithStatus (wdm.h)
La rutina DbgBreakPointWithStatus se divide en el depurador de kernel y envía el valor de Status al depurador.
Sintaxis
__analysis_noreturn NTSYSAPI VOID DbgBreakPointWithStatus(
[in] ULONG Status
);
Parámetros
[in] Status
Especifica un valor de ULONG que se envía al depurador (por ejemplo, un código de estado o una dirección).
Valor devuelto
None
Observaciones
DbgBreakPointWithStatus es idéntico a DbgBreakPoint, excepto el mensaje status .
En equipos x86, el parámetro Status se almacena en el registro eax . En las máquinas que tienen convenciones de llamada de registro, el estado se almacena en el primer registro de argumentos.
Esta rutina genera una excepción que controla el depurador de kernel si se instala una; de lo contrario, se controla mediante el sistema de depuración. Si un depurador no está conectado al sistema, la excepción se puede controlar de forma estándar.
En el modo kernel, una excepción de interrupción que no se controla provocará una comprobación de errores. Sin embargo, puede conectar un depurador en modo kernel a un equipo de destino que ha dejado de responder y tiene habilitada la depuración del kernel. Para obtener más información, vea Depuración de Windows.
Requisitos
Requisito | Value |
---|---|
Cliente mínimo compatible | Disponible en Microsoft Windows 2000 y versiones posteriores. |
Plataforma de destino | Universal |
Encabezado | wdm.h (incluya Wdm.h, Ntddk.h) |
Library | Ntdll.lib (modo de usuario); NtosKrnl.lib (modo kernel) |
Archivo DLL | NtosKrnl.exe |
Reglas de cumplimiento de DDI | DebugBreakUsage(wdm), HwStorPortProhibitedDIs(storport) |