Função DbgBreakPointWithStatus (wdm.h)
A rotina DbgBreakPointWithStatus divide o depurador de kernel e envia o valor de Status para o depurador.
Sintaxe
__analysis_noreturn NTSYSAPI VOID DbgBreakPointWithStatus(
[in] ULONG Status
);
Parâmetros
[in] Status
Especifica um valor ULONG que é enviado para o depurador (por exemplo, um código status ou um endereço).
Retornar valor
Nenhum
Comentários
DbgBreakPointWithStatus é idêntico ao DbgBreakPoint, exceto pela mensagem Status .
Em computadores x86, o parâmetro Status é armazenado no registro eax . Em computadores que têm convenções de chamada de registro, o Status é armazenado no primeiro registro de argumento.
Essa rotina gera uma exceção que é tratada pelo depurador de kernel se uma estiver instalada; caso contrário, ele é manipulado pelo sistema de depuração. Se um depurador não estiver conectado ao sistema, a exceção poderá ser tratada da maneira padrão.
No modo kernel, uma exceção de interrupção que não é tratada causará um bug marcar. No entanto, você pode conectar um depurador no modo kernel a um computador de destino que parou de responder e tem a depuração de kernel habilitada. Para obter mais informações, consulte Depuração do Windows.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Disponível no Microsoft Windows 2000 e posterior. |
| Plataforma de Destino | Universal |
| Cabeçalho | wdm.h (include Wdm.h, Ntddk.h) |
| Biblioteca | Ntdll.lib (modo de usuário); NtosKrnl.lib (modo kernel) |
| DLL | NtosKrnl.exe |
| Regras de conformidade da DDI | DebugBreakUsage(wdm), HwStorPortProhibitedDIs(storport) |