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

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

Синтаксис

typedef struct _KBUGCHECK_REMOVE_PAGES {
  PVOID     Context;
  ULONG     Flags;
  ULONG     BugCheckCode;
  ULONG_PTR Address;
  ULONG_PTR Count;
} KBUGCHECK_REMOVE_PAGES, *PKBUGCHECK_REMOVE_PAGES;

Члены

Context

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

Flags

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

KB_ADD_PAGES_FEATURE_SHIFT       4

KB_REMOVE_PAGES_FEATURE_SHIFT    4

KB_ADD_PAGES_FEATURE_MASK        (0xF << KB_ADD_PAGES_FEATURE_SHIFT)

KB_REMOVE_PAGES_FEATURE_MASK     (0xF << (KB_ADD_PAGES_FEATURE_SHIFT + KB_REMOVE_PAGES_FEATURE_SHIFT))

BugCheckCode

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

Address

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

Count

Указывает количество смежных страниц для удаления из файла аварийного дампа, начиная с виртуального или физического адреса, указанного элементом адреса. Если число> 1 и адрес является виртуальным адресом, страницы связаны в пространстве виртуальной памяти. Если число> 1 и адрес является физическим адресом, страницы связаны в пространстве физической памяти. Подпрограмма обратного вызова может задать для этого члена нулевое значение, чтобы указать, что не нужно удалять страницы из файла аварийного дампа.

Замечания

При вызове подпрограммы обратного вызова KBUGCHECK_REASON_CALLBACK_ROUTINE операционная система задает параметр Reason значение KbCallbackRemovePagesи задает параметр ReasonSpecificData для указания структуры KBUGCHECK_REMOVE_PAGES.

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

Требования