estrutura KBUGCHECK_TRIAGE_DUMP_DATA (wdm.h)

  • Artigo

A estrutura _KBUGCHECK_TRIAGE_DUMP_DATA descreve os dados de despejo usados em conjunto com a rotina de retorno de chamada KBUGCHECK_REASON_CALLBACK_ROUTINE .

Sintaxe

typedef struct _KBUGCHECK_TRIAGE_DUMP_DATA {
  PKTRIAGE_DUMP_DATA_ARRAY DataArray;
  ULONG                    Flags;
  ULONG                    MaxVirtMemSize;
  ULONG                    BugCheckCode;
  ULONG_PTR                BugCheckParameter1;
  ULONG_PTR                BugCheckParameter2;
  ULONG_PTR                BugCheckParameter3;
  ULONG_PTR                BugCheckParameter4;
} KBUGCHECK_TRIAGE_DUMP_DATA, *PKBUGCHECK_TRIAGE_DUMP_DATA;

Membros

DataArray

Um ponteiro para uma estrutura _KBUGCHECK_TRIAGE_DUMP_DATA . Esse é o método que o retorno de chamada usa para fornecer a matriz de dados de bloco de triagem que ele criou.

Flags

Sinalizadores que são passados para o retorno de chamada.

KB_TRIAGE_DUMP_DATA_FLAG_BUGCHECK_ACTIVE 0x00000001

Indica que o retorno de chamada é invocado durante uma verificação de bugs. Atualmente, espera-se que esse sinalizador sempre seja definido.

MaxVirtMemSize

O tamanho máximo de memória virtual em bytes que o retorno de chamada tem permissão para adicionar ao despejo. O tamanho cumulativo das regiões descritas na matriz de dados não deve exceder esse tamanho.

BugCheckCode

Esse valor informa ao retorno de chamada qual código de verificação de bugs foi passado para KeBugcheckEx. A rotina de retorno de chamada pode usar essas informações para decidir se deseja adicionar memória ao arquivo de despejo de memória. Para obter uma lista completa de códigos de marcar de bugs, consulte o arquivo de cabeçalho Bugcodes.h incluído no WDK.

BugCheckParameter1

Parâmetro de verificação de bug 1. Os parâmetros de marcar de bug informam ao retorno de chamada os parâmetros de verificação de bug que foram passados para KeBugcheckEx.

BugCheckParameter2

Parâmetro de verificação de bugs 2. Os parâmetros de marcar de bug informam ao retorno de chamada os parâmetros de verificação de bug que foram passados para KeBugcheckEx.

BugCheckParameter3

Parâmetro de verificação de bugs 3. Os parâmetros de marcar de bug informam ao retorno de chamada os parâmetros de verificação de bug que foram passados para KeBugcheckEx.

BugCheckParameter4

Parâmetro de verificação de bugs 4. Os parâmetros de marcar de bug informam ao retorno de chamada os parâmetros de verificação de bug que foram passados para KeBugcheckEx.

Comentários

O driver recebe uma estrutura desse tipo como um parâmetro para sua rotina de retorno de chamada KBUGCHECK_REASON_CALLBACK_ROUTINE.

Na rotina de retorno de chamada, o driver chama a função KeAddTriageDumpDataBlock para modificar uma matriz de dados de despejo.

Requisitos

Requisito Valor
Cabeçalho wdm.h

Confira também

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