estructura KBUGCHECK_SECONDARY_DUMP_DATA_EX (wdm.h)

La estructura KBUGCHECK_SECONDARY_DUMP_DATA_EX describe los datos de varias partes que se van a escribir KBUGCHECK_REASON_CALLBACK_ROUTINE rutina de devolución de llamada en el archivo de volcado de memoria.

Sintaxis

typedef struct _KBUGCHECK_SECONDARY_DUMP_DATA_EX {
  PVOID     InBuffer;
  ULONG     InBufferLength;
  ULONG     MaximumAllowed;
  GUID      Guid;
  PVOID     OutBuffer;
  ULONG     OutBufferLength;
  PVOID     Context;
  ULONG     Flags;
  ULONG     DumpType;
  ULONG     BugCheckCode;
  ULONG_PTR BugCheckParameter1;
  ULONG_PTR BugCheckParameter2;
  ULONG_PTR BugCheckParameter3;
  ULONG_PTR BugCheckParameter4;
} KBUGCHECK_SECONDARY_DUMP_DATA_EX, *PKBUGCHECK_SECONDARY_DUMP_DATA_EX;

Miembros

InBuffer

Puntero a un búfer asignado por el sistema.

InBufferLength

Especifica el tamaño del búfer, en bytes, especificado por el miembro InBuffer .

MaximumAllowed

Especifica la cantidad máxima de datos que la rutina de KBUGCHECK_REASON_CALLBACK_ROUTINE puede escribir en el archivo de volcado de memoria.

Guid

Especifica un GUID que identifica los datos del volcado de memoria del controlador. (Los controladores deben usar GUID únicos para marcar sus datos de volcado de memoria. Use la herramienta GuidGen.exe para generar GUID para el controlador.

OutBuffer

Puntero al búfer donde el controlador escribe sus datos de volcado de memoria o NULL.

OutBufferLength

Especifica el tamaño del búfer, en bytes, especificado por el miembro OutBuffer .

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, las marcas se inicializan en cero.

DumpType

Uno de los siguientes tipos de volcado de memoria.

    DUMP_TYPE_INVALID           = -1,
    DUMP_TYPE_UNKNOWN           = 0,
    DUMP_TYPE_FULL              = 1,
    DUMP_TYPE_SUMMARY           = 2,
    DUMP_TYPE_HEADER            = 3,
    DUMP_TYPE_TRIAGE            = 4,
    DUMP_TYPE_BITMAP_FULL       = 5,
    DUMP_TYPE_BITMAP_KERNEL     = 6,
    DUMP_TYPE_AUTOMATIC         = 7

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.

BugCheckParameter1

Parámetro de comprobación de errores 1. Los parámetros de comprobación de errores informan a la devolución de llamada de los parámetros de comprobación de errores que se pasaron a KeBugcheckEx.

BugCheckParameter2

Parámetro de comprobación de errores 2. Los parámetros de comprobación de errores informan a la devolución de llamada de los parámetros de comprobación de errores que se pasaron a KeBugcheckEx.

BugCheckParameter3

Parámetro de comprobación de errores 3. Los parámetros de comprobación de errores informan a la devolución de llamada de los parámetros de comprobación de errores que se pasaron a KeBugcheckEx.

BugCheckParameter4

Parámetro de comprobación de errores 4. Los parámetros de comprobación de errores informan a la devolución de llamada de los parámetros de comprobación de errores que se pasaron a KeBugcheckEx.

Comentarios

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

Requisitos

Requisito	Valor
Header	wdm.h

Consulte también

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