KBUGCHECK_REASON_CALLBACK_ROUTINE função de retorno de chamada (wdm.h)

Artigo
02/07/2025

Funções de retorno de chamada implementadas pelo driver que o sistema executa quando emite uma verificação de bug.

Consulte KBUGCHECK_CALLBACK_REASON para obter informações sobre os tipos de retorno de chamada disponíveis.

Sintaxe

KBUGCHECK_REASON_CALLBACK_ROUTINE KbugcheckReasonCallbackRoutine;

void KbugcheckReasonCallbackRoutine(
  [in]      KBUGCHECK_CALLBACK_REASON Reason,
  [in]      _KBUGCHECK_REASON_CALLBACK_RECORD *Record,
  [in, out] PVOID ReasonSpecificData,
  [in]      ULONG ReasonSpecificDataLength
)
{...}

Parâmetros

[in] Reason

Uma enumeração do tipo KBUGCHECK_CALLBACK_REASON que especifica o motivo da chamada para a rotina de retorno de chamada.

[in] Record

Um ponteiro para a estrutura de KBUGCHECK_REASON_CALLBACK_RECORD que o driver forneceu quando registrou esse retorno de chamada. Para obter mais informações, consulte a descrição do parâmetro CallbackRecord em KeRegisterBugCheckReasonCallback.

[in, out] ReasonSpecificData

Ponteiro para um buffer que contém uma estrutura de tipo determinada pela tabela abaixo. Determinados membros dessa estrutura são preenchidos pelo sistema operacional antes de chamar a rotina de retorno de chamada e outros membros devem ser preenchidos pela rotina de retorno de chamada. Para obter mais informações, consulte Escrevendo uma rotina de retorno de chamada de verificação de bugs.

Valor	Estrutura de dados
KbCallbackSecondaryDumpData	KBUGCHECK_SECONDARY_DUMP_DATA
KbCallbackDumpIo	KBUGCHECK_DUMP_IO
KbCallbackAddPages	KBUGCHECK_ADD_PAGES
KbCallbackSecondaryMultiPartDumpData	KBUGCHECK_SECONDARY_DUMP_DATA_EX
KbCallbackRemovePages	KBUGCHECK_REMOVE_PAGES
KbCallbackTriageDumpData	KBUGCHECK_TRIAGE_DUMP_DATA

[in] ReasonSpecificDataLength

Especifica o tamanho, em bytes, do buffer ao qual o parâmetro ReasonSpecificData aponta.

Valor de retorno

Nenhum

Observações

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.

Para obter um código de exemplo que mostra como gravar dados no arquivo de despejo de falha, consulte DMF_CrashDump.

Requisitos

Requisito	Valor
da Plataforma de Destino	Área de trabalho
cabeçalho	wdm.h (include Wdm.h, Ntddk.h, Ntifs.h)
IRQL	Chamado no HIGH_LEVEL.

Consulte também

KBUGCHECK_ADD_PAGES

KBUGCHECK_CALLBACK_REASON

KBUGCHECK_REASON_CALLBACK_RECORD

KeRegisterBugCheckReasonCallback

KeDeregisterBugCheckReasonCallback

gravando uma rotina de retorno de chamada de verificação de bugs.

Partilhar via