Compartir a través de


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)

Consulte también

DbgBreakPoint

KdBreakPoint

KdBreakPointWithStatus