Função KeRegisterBugCheckReasonCallback (wdm.h)

Artigo
02/07/2025

A função KeRegisterBugCheckReasonCallback registra uma rotina de retorno de chamada executada quando o sistema operacional emite uma verificação de bugs.

Sintaxe

BOOLEAN KeRegisterBugCheckReasonCallback(
  [out] PKBUGCHECK_REASON_CALLBACK_RECORD  CallbackRecord,
  [in]  PKBUGCHECK_REASON_CALLBACK_ROUTINE CallbackRoutine,
  [in]  KBUGCHECK_CALLBACK_REASON          Reason,
  [in]  PUCHAR                             Component
);

Parâmetros

[out] CallbackRecord

Um ponteiro para uma estrutura de KBUGCHECK_REASON_CALLBACK_RECORD que foi inicializada por uma chamada para a rotina KeInitializeCallbackRecord descrita nas macros de kernel do Windows.

[in] CallbackRoutine

Um ponteiro para uma rotina de retorno de chamada do tipo KBUGCHECK_REASON_CALLBACK_ROUTINE a ser registrado. Para obter informações sobre como implementar essa rotina de retorno de chamada, consulte Escrevendo uma rotina de retorno de chamada de verificação de bugs.

[in] Reason

Uma enumeração do tipo KBUGCHECK_CALLBACK_REASON que especifica o tipo de rotina de retorno de chamada que callbackRoutine aponta.

[in] Component

Um ponteiro para uma cadeia de caracteres ANSI terminada em nulo que identifica o chamador. Por exemplo, você pode selecionar uma cadeia de caracteres que descreve o driver do dispositivo ou que contém o nome do dispositivo. Você pode usar a extensão !bugdump depurador para exibir os dados de despejo de memória associados a essa cadeia de caracteres.

Valor de retorno

KeRegisterBugCheckReasonCallback retornará verdadeiro se a rotina de retorno de chamada for registrada com êxito; caso contrário, ele retornará FALSE .

Observações

Os drivers podem usar KeRegisterBugCheckReasonCallback para registrar rotinas executadas durante uma verificação de bugs do sistema.

Para obter descrições de cada tipo de retorno de chamada, consulte KBUGCHECK_CALLBACK_REASON.

Os drivers podem usar a rotinaKeDeregisterBugCheckReasonCallbackpara remover o registro de retorno de chamada de verificação de bugs. Qualquer driver que possa ser descarregado deve remover os registros de todos os seus retornos de chamada em sua rotina de Descarregar.

Para obter informações sobre como implementar essas rotinas de retorno de chamada, consulte Escrevendo uma rotina de retorno de chamada de verificação de bugs.

Para exibir dados de despejo secundários, você pode usar o método IDebugDataSpaces3::ReadTagged** em uma extensão de depurador. Outra opção é depurar a própria rotina de retorno de chamada de verificação de bugs. Para obter mais informações sobre depuradores e extensões de depurador, consulte de depuração do Windows.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Disponível no Windows XP Service Pack 1 (SP1), Windows Server 2003 e versões posteriores do Windows.
da Plataforma de Destino	Universal
cabeçalho	wdm.h (include Wdm.h, Ntddk.h, Ntifs.h)
biblioteca	NtosKrnl.lib
de DLL	NtosKrnl.exe
IRQL	Qualquer nível