estructura de KBUGCHECK_ADD_PAGES (wdm.h)

La estructura de 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 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 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. Al entrar a la rutina de devolución de llamada, flags 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 el 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 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 agregar ninguna página al archivo de volcado de memoria.

Comentarios

En una llamada a la rutina de devolución de llamada KbCallbackAddPages, el sistema operativo establece el parámetro Reason en KbCallbackAddPages y 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, vea 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	Value
Cliente mínimo compatible	Compatible con Windows Server 2008 y versiones posteriores de Windows.
Encabezado	wdm.h (incluya Wdm.h, Ntddk.h, Ntifs.h)

Consulte también

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