Compartilhar via


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)

Consulte também

DbgBreakPoint

do KdBreakPoint

KdBreakPointWithStatus