estrutura KBUGCHECK_SECONDARY_DUMP_DATA_EX (wdm.h)

A estrutura KBUGCHECK_SECONDARY_DUMP_DATA_EX descreve os dados de várias partes a serem gravados por KBUGCHECK_REASON_CALLBACK_ROUTINE rotina de retorno de chamada para o arquivo de despejo de memória.

Sintaxe

typedef struct _KBUGCHECK_SECONDARY_DUMP_DATA_EX {
  PVOID     InBuffer;
  ULONG     InBufferLength;
  ULONG     MaximumAllowed;
  GUID      Guid;
  PVOID     OutBuffer;
  ULONG     OutBufferLength;
  PVOID     Context;
  ULONG     Flags;
  ULONG     DumpType;
  ULONG     BugCheckCode;
  ULONG_PTR BugCheckParameter1;
  ULONG_PTR BugCheckParameter2;
  ULONG_PTR BugCheckParameter3;
  ULONG_PTR BugCheckParameter4;
} KBUGCHECK_SECONDARY_DUMP_DATA_EX, *PKBUGCHECK_SECONDARY_DUMP_DATA_EX;

Membros

InBuffer

Ponteiro para um buffer alocado pelo sistema.

InBufferLength

Especifica o tamanho do buffer, em bytes, especificado pelo membro InBuffer .

MaximumAllowed

Especifica a quantidade máxima de dados que a rotina de KBUGCHECK_REASON_CALLBACK_ROUTINE pode gravar no arquivo de despejo de memória.

Guid

Especifica um GUID que identifica os dados de despejo de memória do driver. (Os drivers devem usar GUIDs exclusivos para marcar seus dados de despejo de memória. Use a ferramenta GuidGen.exe para gerar GUIDs para o driver.

OutBuffer

Ponteiro para o buffer em que o driver grava seus dados de despejo de memória ou NULL.

OutBufferLength

Especifica o tamanho do buffer, em bytes, que foi especificado pelo membro OutBuffer .

Context

Contém dados de contexto privados para o uso exclusivo da rotina de retorno de chamada. A rotina de retorno de chamada pode definir esse membro como qualquer valor. Normalmente, se a rotina de retorno de chamada precisar ser chamada mais de uma vez, a rotina definirá esse membro para apontar para um buffer fornecido pelo driver durante a chamada inicial. Durante as chamadas subsequentes, a rotina de retorno de chamada pode ler o conteúdo anterior desse buffer e atualizar seu conteúdo. Antes da chamada inicial para a rotina de retorno de chamada, Context é NULL.

Flags

Contém sinalizadores que descrevem a solicitação de adicionar página. A rotina de retorno de chamada deve definir o valor desse membro. Defina esse membro como OR bit a bit de um ou mais dos seguintes bits de sinalizador:

KB_ADD_PAGES_FLAG_VIRTUAL_ADDRESS

Indica que o membro Address contém um endereço virtual.

KB_ADD_PAGES_FLAG_PHYSICAL_ADDRESS

Indica que o membro Address contém um endereço físico.

KB_ADD_PAGES_FLAG_ADDITIONAL_RANGES_EXIST

Indica que a rotina de retorno de chamada solicita que ela seja chamada novamente para que possa adicionar mais páginas.

A rotina de retorno de chamada deve definir o sinalizador KB_ADD_PAGES_FLAG_VIRTUAL_ADDRESS ou o sinalizador KB_ADD_PAGES_FLAG_PHYSICAL_ADDRESS, mas não ambos. Na entrada para a rotina de retorno de chamada, Flags é inicializado como zero.

DumpType

Um dos tipos de despejo a seguir.

    DUMP_TYPE_INVALID           = -1,
    DUMP_TYPE_UNKNOWN           = 0,
    DUMP_TYPE_FULL              = 1,
    DUMP_TYPE_SUMMARY           = 2,
    DUMP_TYPE_HEADER            = 3,
    DUMP_TYPE_TRIAGE            = 4,
    DUMP_TYPE_BITMAP_FULL       = 5,
    DUMP_TYPE_BITMAP_KERNEL     = 6,
    DUMP_TYPE_AUTOMATIC         = 7

BugCheckCode

Contém um código de marcar de bugs, que especifica o motivo da marcar de bugs. A rotina de retorno de chamada pode usar essas informações para decidir se deseja adicionar páginas 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. O bug marcar parâmetros 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. O bug marcar parâmetros 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. O bug marcar parâmetros 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 bug 4. O bug marcar parâmetros informam ao retorno de chamada os parâmetros de verificação de bug que foram passados para KeBugcheckEx.

Comentários

Para obter mais informações sobre bugs marcar rotinas de retorno de chamada, consulte Escrevendo uma rotina de retorno de chamada de verificação de bugs.

Requisitos

Requisito	Valor
Cabeçalho	wdm.h

Confira também

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