estructura KBUGCHECK_REMOVE_PAGES (wdm.h)

La estructura de KBUGCHECK_REMOVE_PAGES describe una o varias páginas de datos proporcionados por el controlador que se van a quitar mediante una rutina de devolución de llamada KBUGCHECK_REASON_CALLBACK_ROUTINE del archivo de volcado de memoria.

Sintaxis

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

Miembros

Context

Contiene datos de contexto privado para el uso exclusivo de la rutina de devolución de llamada. La rutina de devolución de llamada puede establecer este miembro en cualquier valor. Normalmente, si se debe llamar a la rutina de devolución de llamada más de una vez, la rutina establece que este miembro apunte a un búfer proporcionado por el controlador durante la llamada inicial. Durante las llamadas posteriores, la rutina de devolución de llamada puede leer el contenido anterior de este búfer y actualizar su contenido. Antes de la llamada inicial a la rutina de devolución de llamada, Context es NULL.

Flags

Contiene marcas que describen la solicitud remove-page. La rutina de devolución de llamada debe establecer el valor de este miembro. Establezca este miembro en el or bit a bit de uno o varios de los siguientes bits de marca:

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

Contiene un código de comprobación de errores, que especifica el motivo de la comprobación de errores. La rutina de devolución de llamada puede usar esta información para decidir si desea agregar páginas al archivo de volcado de memoria. Para obtener una lista completa de los códigos de comprobación de errores, consulte el archivo de encabezado Bugcodes.h incluido en el WDK.

Address

Especifica la dirección física o virtual de la página o páginas a las que se quitan las solicitudes rutinarias de devolución de llamada del archivo de volcado de memoria.

Count

Especifica el número de páginas contiguas que se van a quitar del archivo de volcado de memoria, empezando por la dirección virtual o física especificada por el miembro Address . Si el recuento> 1 y la dirección son una dirección virtual, las páginas son contiguas en el espacio de memoria virtual. Si el recuento> 1 y la dirección son una dirección física, las páginas son contiguas en el espacio de memoria física. La rutina de devolución de llamada puede establecer este miembro en cero para indicar que no es necesario quitar ninguna página del archivo de volcado de memoria.

Comentarios

En una llamada a la rutina de devolución de llamada KBUGCHECK_REASON_CALLBACK_ROUTINE , el sistema operativo establece el parámetro Reason en KbCallbackRemovePages y establece el parámetro ReasonSpecificData para que apunte a una estructura de KBUGCHECK_REMOVE_PAGES .

Para obtener más información sobre las rutinas de devolución de llamada de comprobación de errores, consulte Escribir una rutina de devolución de llamada de comprobación de errores.

Requisitos