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

  • Artigo

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

[in] ReasonSpecificDataLength

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

Retornar valor

Nenhum

Comentários

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 memória, consulte DMF_CrashDump.

Requisitos

Requisito Valor
Plataforma de Destino Área de Trabalho
Cabeçalho wdm.h (include Wdm.h, Ntddk.h, Ntifs.h)
IRQL Chamado em HIGH_LEVEL.

Confira 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.