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

Статья
02/29/2024

Структура 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

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

KB_ADD_PAGES_FLAG_VIRTUAL_ADDRESS

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

KB_ADD_PAGES_FLAG_PHYSICAL_ADDRESS

Указывает, что элемент 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.

Требования

Требование	Значение
Заголовок	wdm.h

См. также раздел

Написание процедуры обратного вызова для проверки ошибок. KBUGCHECK_REASON_CALLBACK_ROUTINE

Поделиться через