estructura KBUGCHECK_ADD_PAGES (wdm.h)

La estructura KBUGCHECK_ADD_PAGES describe una o varias páginas de datos proporcionados por el controlador que va a escribir una función de devolución de llamada KBUGCHECK_REASON_CALLBACK_ROUTINE en el archivo de volcado de memoria.

Sintaxis

typedef struct _KBUGCHECK_ADD_PAGES {
  PVOID     Context;
  ULONG     Flags;
  ULONG     BugCheckCode;
  ULONG_PTR Address;
  ULONG_PTR Count;
} KBUGCHECK_ADD_PAGES, *PKBUGCHECK_ADD_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 es necesario llamar a la rutina de devolución de llamada más de una vez, la rutina establece este miembro para que 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 de la página de complemento. 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_FLAG_VIRTUAL_ADDRESS

Indica que el miembro address contiene una dirección virtual.

KB_ADD_PAGES_FLAG_PHYSICAL_ADDRESS

Indica que el miembro address contiene una dirección física.

KB_ADD_PAGES_FLAG_ADDITIONAL_RANGES_EXIST

Indica que la rutina de devolución de llamada solicita que se vuelva a llamar para que pueda agregar más páginas.

La rutina de devolución de llamada debe establecer la marca KB_ADD_PAGES_FLAG_VIRTUAL_ADDRESS o la marca KB_ADD_PAGES_FLAG_PHYSICAL_ADDRESS, pero no ambas. En la entrada a la rutina de devolución de llamada, marcas se inicializa en cero.

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 WDK.

Address

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

Count

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

Observaciones

En una llamada al KbCallbackAddPages rutina de devolución de llamada, el sistema operativo establece el parámetro reason de en KbCallbackAddPagesy establece el parámetro ReasonSpecificData para que apunte a una estructura de KBUGCHECK_ADD_PAGES.

Para obtener más información sobre cómo se usa esta estructura, consulte Escribir una rutina de devolución de llamada de comprobación de errores y KBUGCHECK_REASON_CALLBACK_ROUTINE función de devolución de llamada.

Requisitos

Requisito	Valor
cliente mínimo admitido	Compatible con Windows Server 2008 y versiones posteriores de Windows.
encabezado de	wdm.h (include Wdm.h, Ntddk.h, Ntifs.h)

Consulte también

escribir una rutina de devolución de llamada de comprobación de errores.