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

Artigo
08/08/2023

Funções de retorno de chamada implementadas pelo driver que o sistema executa quando emite um bug marcar.

Consulte KBUGCHECK_CALLBACK_REASON para obter informações sobre 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 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 do 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