KBUGCHECK_CALLBACK_REASON enumeração (wdm.h)

Artigo
02/07/2025

O tipo de enumeração KBUGCHECK_CALLBACK_REASON especifica as situações em que um retorno de chamada de verificação de bug é executado.

Sintaxe

typedef enum _KBUGCHECK_CALLBACK_REASON {
  KbCallbackInvalid,
  KbCallbackReserved1,
  KbCallbackSecondaryDumpData,
  KbCallbackDumpIo,
  KbCallbackAddPages,
  KbCallbackSecondaryMultiPartDumpData,
  KbCallbackRemovePages,
  KbCallbackTriageDumpData,
  KbCallbackReserved2,
  KbCallbackReserved3
} KBUGCHECK_CALLBACK_REASON;

Constantes


`KbCallbackInvalid` Reservado para uso do sistema. Não use.
`KbCallbackReserved1` Reservado para uso do sistema. Não use.
`KbCallbackSecondaryDumpData` A função de retorno de chamada fornece dados para acrescentar à área de dados secundária do arquivo de despejo de falha quando o sistema emite uma verificação de bugs. Para obter mais informações sobre esse tipo de retorno de chamada, consulte Implementando uma rotina de retorno de chamada KbCallbackSecondaryDumpData.
`KbCallbackDumpIo` Especifica que o sistema deve chamar a função de retorno de chamada sempre que gravar dados em um arquivo de despejo de falha. Drivers para dispositivos que monitoram o estado do sistema podem usar esse tipo de retorno de chamada. Para obter mais informações sobre esse tipo de retorno de chamada, consulte Implementando uma rotina de retorno de chamada KbCallbackDumpIo.
`KbCallbackAddPages` A função de retorno de chamada adiciona uma ou mais páginas de dados específicos do driver à seção primária do arquivo de despejo de falha quando o sistema operacional emite uma verificação de bugs. Para obter mais informações sobre esse tipo de retorno de chamada, consulte Implementando uma rotina de retorno de chamada KbCallbackAddPages.
`KbCallbackSecondaryMultiPartDumpData` Especifica que o retorno de chamada é executado para obter a quantidade de dados que o driver deseja armazenar no arquivo de despejo. Esse valor de enumeração tem suporte no Windows Server 2008 e versões posteriores do Windows.
`KbCallbackRemovePages` A função de retorno de chamada remove uma ou mais páginas de dados fornecidos pelo driver do arquivo de despejo de memória. Para obter mais informações, consulte KBUGCHECK_REMOVE_PAGES.
`KbCallbackTriageDumpData` Especifica que o retorno de chamada é executado para adicionar intervalos de memória virtual que o driver deseja preservar no arquivo de minidump gravado. Esse valor de enumeração tem suporte a partir do Windows 10, versão 1809 e Windows Server 2019. Para obter mais informações sobre esse tipo de retorno de chamada, consulte Implementando uma rotina de retorno de chamada KbCallbackTriageDumpData.
`KbCallbackReserved2` Reservado para uso do sistema. Não use.
`KbCallbackReserved3` Reservado para uso do sistema. Não use.

Observações

Um driver usa essa enumeração para especificar o tipo de rotina de retorno de chamada KBUGCHECK_REASON_CALLBACK_ROUTINE para registrar quando chama a funçãoKeRegisterBugCheckReasonCallback.

Para obter informações sobre como essa enumeração é usada, consulte Escrevendo uma rotina de retorno de chamada de verificação de bugs.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Com suporte no Windows XP com Service Pack 1 (SP1), Windows Server 2003 e versões posteriores do sistema operacional Windows.
cabeçalho	wdm.h (include Wdm.h, Ntddk.h, Ntifs.h)

Consulte também

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

KBUGCHECK_REASON_CALLBACK_RECORD

KeRegisterBugCheckReasonCallback

Compartilhar via