Função DbgBreakPointWithStatus (wdm.h)
O DbgBreakPointWithStatus quebras de rotina no 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 de status ou um endereço).
Valor de retorno
Nenhum
Observações
DbgBreakPointWithStatus é idêntico a 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, 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 é tratado 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á uma verificação de bug. 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 de depuração do Windows.
Requisitos
Requisito | Valor |
---|---|
de cliente com suporte mínimo | Disponível no Microsoft Windows 2000 e posterior. |
da Plataforma de Destino | Universal |
cabeçalho | wdm.h (include Wdm.h, Ntddk.h) |
biblioteca | Ntdll.lib (modo de usuário); NtosKrnl.lib (modo kernel) |
de DLL | NtosKrnl.exe |
regras de conformidade de DDI | DebugBreakUsage(wdm), HwStorPortProhibitedDIs(storport) |