структура KBUGCHECK_SECONDARY_DUMP_DATA_EX (wdm.h)

Структура KBUGCHECK_SECONDARY_DUMP_DATA_EX описывает многопартийные данные, которые записываются KBUGCHECK_REASON_CALLBACK_ROUTINE подпрограммой обратного вызова в файл аварийного дампа.

Синтаксис

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;

Члены

InBuffer

Указатель на буфер, выделенный системой.

InBufferLength

Задает размер буфера в байтах, указанный элементом InBuffer.

MaximumAllowed

Указывает максимальный объем данных, которые программа KBUGCHECK_REASON_CALLBACK_ROUTINE может записывать в файл аварийного дампа.

Guid

Указывает GUID, определяющий данные аварийного дампа драйвера. (Драйверы должны использовать уникальные идентификаторы GUID, чтобы пометить данные аварийного дампа. Используйте средство GuidGen.exe для создания идентификаторов GUID для драйвера.

OutBuffer

Указатель на буфер, где драйвер записывает данные аварийного дампа или NULL.

OutBufferLength

Задает размер буфера в байтах, который был указан элементом OutBuffer.

Context

Содержит данные частного контекста для эксклюзивного использования подпрограммы обратного вызова. Подпрограмма обратного вызова может задать для этого члена любое значение. Как правило, если подпрограмма обратного вызова должна вызываться несколько раз, подпрограмма задает этому члену указатель на буфер, предоставленный драйвером во время первоначального вызова. Во время последующих вызовов подпрограмма обратного вызова может считывать предыдущее содержимое этого буфера и обновлять его содержимое. Перед начальным вызовом подпрограммы обратного вызова контекст имеет значение NULL.

Flags

Содержит флаги, описывающие запрос на страницу надстройки. Подпрограмма обратного вызова должна задать значение этого члена. Задайте для этого элемента побитовое значение OR одного или нескольких из следующих битов флага:

KB_ADD_PAGES_FLAG_VIRTUAL_ADDRESS

Указывает, что элемент адреса содержит виртуальный адрес.

KB_ADD_PAGES_FLAG_PHYSICAL_ADDRESS

Указывает, что элемент адреса содержит физический адрес.

KB_ADD_PAGES_FLAG_ADDITIONAL_RANGES_EXIST

Указывает, что подпрограмма обратного вызова запрашивает повторное вызов, чтобы добавить дополнительные страницы.

Подпрограмма обратного вызова должна задать флаг KB_ADD_PAGES_FLAG_VIRTUAL_ADDRESS или флаг KB_ADD_PAGES_FLAG_PHYSICAL_ADDRESS, но не оба. При входе в подпрограмму обратного вызова флаги инициализированы до нуля.

DumpType

Один из следующих типов дампа.

    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

Содержит код проверки ошибок, указывающий причину проверки ошибки. Подпрограмма обратного вызова может использовать эти сведения, чтобы решить, следует ли добавлять любые страницы в файл аварийного дампа. Полный список кодов проверки ошибок см. в файле заголовка Bugcodes.h, включенном в WDK.

BugCheckParameter1

Параметр проверки ошибок 1. Параметры проверки ошибок сообщают обратному вызову параметры ошибки, переданные в KeBugcheckEx.

BugCheckParameter2

Параметр проверки ошибок 2. Параметры проверки ошибок сообщают обратному вызову параметры ошибки, переданные в KeBugcheckEx.

BugCheckParameter3

Параметр проверки ошибок 3. Параметры проверки ошибок сообщают обратному вызову параметры ошибки, переданные в KeBugcheckEx.

BugCheckParameter4

Параметр проверки ошибок 4. Параметры проверки ошибок сообщают обратному вызову параметры ошибки, переданные в KeBugcheckEx.

Замечания

Дополнительные сведения о подпрограммах обратного вызова проверки ошибок см. в записи подпрограммы обратного вызова проверки ошибок.

Требования

См. также

написание подпрограммы обратного вызова проверки ошибок. KBUGCHECK_REASON_CALLBACK_ROUTINE