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


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

Структура _KBUGCHECK_TRIAGE_DUMP_DATA описывает данные дампа, используемые в сочетании с подпрограммой обратного вызова KBUGCHECK_REASON_CALLBACK_ROUTINE.

Синтаксис

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;

Члены

DataArray

Указатель на структуру _KBUGCHECK_TRIAGE_DUMP_DATA. Это метод обратного вызова, который используется для предоставления созданного массива данных блока триажа.

Flags

Флаги, передаваемые в обратный вызов.

KB_TRIAGE_DUMP_DATA_FLAG_BUGCHECK_ACTIVE 0x00000001

Указывает, что обратный вызов вызывается во время проверки ошибки. В настоящее время этот флаг, как ожидается, всегда будет задан.

MaxVirtMemSize

Максимальный размер виртуальной памяти в байтах обратного вызова разрешено добавить в дамп. Совокупный размер регионов, описанных в массиве данных, не должен превышать этот размер.

BugCheckCode

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

BugCheckParameter1

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

BugCheckParameter2

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

BugCheckParameter3

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

BugCheckParameter4

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

Замечания

Драйвер получает структуру этого типа в качестве параметра для его KBUGCHECK_REASON_CALLBACK_ROUTINE подпрограммы обратного вызова.

Из подпрограммы обратного вызова драйвер вызывает функцию KeAddTriageDumpDataBlock для изменения массива данных дампа.

Требования

Требование Ценность
заголовка wdm.h

См. также

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