Função KeBugCheck (ntddk.h)
A rotina de KeBugCheck
Sintaxe
void KeBugCheck(
[in] ULONG BugCheckCode
);
Parâmetros
[in] BugCheckCode
Especifica um valor que indica o motivo da verificação de bugs.
Valor de retorno
Nenhum
Observações
Uma verificação de bug é um erro detectado pelo sistema que causa um desligamento imediato e controlado do sistema. Vários componentes do modo kernel executam a verificação de consistência em tempo de execução. Quando esse componente descobre uma inconsistência irrecuperável, ele faz com que uma verificação de bug seja gerada.
Sempre que possível, todos os componentes do modo kernel devem registrar um erro e continuar a ser executados, em vez de chamar KeBugCheck. Por exemplo, se um driver não puder alocar os recursos necessários, ele deverá registrar um erro para que o sistema continue a ser executado; ele não deve gerar uma verificação de bug.
Um driver ou outro componente do modo kernel deve chamar essa rotina apenas em casos de um erro fatal e irrecuperável que possa corromper o próprio sistema.
KeBugCheck podem ser úteis nos estágios iniciais do desenvolvimento de um driver ou enquanto ele está em teste. Nessas circunstâncias, o BugCheckCode passado para essa rotina deve ser distinto daqueles códigos já em uso pelo Windows ou por seus drivers. Para obter uma lista desses códigos, consulte códigos de verificação de bugs.
No entanto, mesmo durante o desenvolvimento do driver, essa rotina é apenas de utilitário limitado, pois resulta em um desligamento completo do sistema. Um método de depuração mais eficaz é anexar um depurador de kernel ao sistema e, em seguida, usar rotinas que enviam mensagens para o depurador ou invadem o depurador. Para obter mais informações, consulte Introdução ao WinDbg (modo kernel).
Quando uma verificação de bug é inevitável, a maioria dos componentes do sistema chama KeBugCheckEx, que fornece mais informações sobre a causa de tal inconsistência do que KeBugCheck.
Requisitos
| Requisito | Valor |
|---|---|
| de cliente com suporte mínimo | Disponível a partir do Windows 2000. |
| da Plataforma de Destino |
Universal |
| cabeçalho | ntddk.h (inclua Ntddk.h) |
| biblioteca | NtosKrnl.lib |
| de DLL |
NtosKrnl.exe |
| IRQL | Qualquer nível |