enumeración MINIDUMP_CALLBACK_TYPE (minidumpapiset.h)

Identifica el tipo de información devuelta por la función MiniDumpCallback . No todos los errores de memoria provocarán una devolución de llamada; por ejemplo, si el error está dentro de una pila, el error se considera irrecuperable y se producirá un error en el minivolcado.

Syntax

typedef enum _MINIDUMP_CALLBACK_TYPE {
  ModuleCallback,
  ThreadCallback,
  ThreadExCallback,
  IncludeThreadCallback,
  IncludeModuleCallback,
  MemoryCallback,
  CancelCallback,
  WriteKernelMinidumpCallback,
  KernelMinidumpStatusCallback,
  RemoveMemoryCallback,
  IncludeVmRegionCallback,
  IoStartCallback,
  IoWriteAllCallback,
  IoFinishCallback,
  ReadMemoryFailureCallback,
  SecondaryFlagsCallback,
  IsProcessSnapshotCallback,
  VmStartCallback,
  VmQueryCallback,
  VmPreReadCallback,
  VmPostReadCallback
} MINIDUMP_CALLBACK_TYPE;

Constantes

ModuleCallback La función de devolución de llamada devuelve información del módulo.
ThreadCallback La función de devolución de llamada devuelve información de subproceso.
ThreadExCallback La función de devolución de llamada devuelve información de subproceso extendida.
IncludeThreadCallback La función de devolución de llamada indica qué subprocesos se van a incluir. Se llama como la biblioteca de minivolcados. enumerar los subprocesos de un proceso, en lugar de después de la información recopilada, tal como está con ThreadCallback o ThreadExCallback. Se llama a para cada subproceso. Si la función de devolución de llamada devuelve FALSE, se excluye el subproceso actual. Esto permite al autor de la llamada obtener información para un subconjunto de los subprocesos de un proceso, sin suspender subprocesos que no son de interés. Como alternativa, puede modificar ThreadWriteFlags. miembro del MINIDUMP_CALLBACK_OUTPUT estructura y devuelve TRUE para evitar la recopilación de información innecesaria para de la interfaz de usuario.
IncludeModuleCallback La función de devolución de llamada indica qué módulos se van a incluir. Se llama a la función de devolución de llamada como . la biblioteca de minivolcados enumera los módulos de un proceso, en lugar de después de recopilar la información, ya que es con ModuleCallback. Se llama a para cada módulo. Si la función de devolución de llamada devuelve FALSE, se excluye el módulo actual. Como alternativa, puede modificar el ModuleWriteFlags miembro del estructura de MINIDUMP_CALLBACK_OUTPUT y devuelve TRUE para evitar la recopilación de información innecesaria para el módulo.
MemoryCallback La función de devolución de llamada devuelve una región de memoria que se va a incluir en el volcado de memoria. Solo se llama a la devolución de llamada. para volcados generados sin la marca MiniDumpWithFullMemory. Si la función de devolución de llamada devuelve FALSE o una región de tamaño 0, no se volverá a llamar a la devolución de llamada. DbgHelp 6.1 y versiones anteriores: Este valor no se admite.
CancelCallback La función de devolución de llamada devuelve información de cancelación. DbgHelp 6.1 y versiones anteriores: Este valor no se admite.
WriteKernelMinidumpCallback El minivolcado en modo de usuario se ha completado correctamente. Para iniciar un minivolcado en modo kernel, la devolución de llamada debe devolver TRUE y establecer el miembro Handle de . MINIDUMP_CALLBACK_OUTPUT estructura. DbgHelp 6.1 y versiones anteriores: Este valor no se admite.
KernelMinidumpStatusCallback La función de devolución de llamada devuelve información de estado para el minivolcado del kernel. DbgHelp 6.1 y versiones anteriores: Este valor no se admite.
RemoveMemoryCallback La función de devolución de llamada devuelve una región de memoria que se va a excluir del volcado de memoria. Solo se llama a la devolución de llamada. para volcados generados sin la marca MiniDumpWithFullMemory . Si la devolución de llamada la función devuelve FALSE o una región de tamaño 0, no se volverá a llamar a la devolución de llamada. DbgHelp 6.3 y versiones anteriores: Este valor no se admite.
IncludeVmRegionCallback La función de devolución de llamada devuelve información sobre la región de memoria virtual. Se llama dos veces para cada uno. región durante el paso de escritura de memoria completa. El miembro VmRegion del estructura de MINIDUMP_CALLBACK_OUTPUT contiene la región de memoria actual. Puede modificar la dirección base y el tamaño de la región, siempre que el nuevo región sigue siendo un subconjunto de la región original; Se omiten los cambios realizados en otros miembros. Si la devolución de llamada devuelve TRUE y establece el miembro Continue de MINIDUMP_CALLBACK_OUTPUT a TRUE, la biblioteca de minivolcado usará la región especificada por VmRegion como región que se va a escribir. Si la devolución de llamada devuelve FALSE o si Continue es FALSE, No se llamará a la devolución de llamada para regiones de memoria adicionales. DbgHelp 6.4 y versiones anteriores: Este valor no se admite.
IoStartCallback La función de devolución de llamada indica que el autor de la llamada proporcionará una rutina de E/S alternativa. Si la devolución de llamada devuelve TRUE y establece el miembro Status de MINIDUMP_CALLBACK_OUTPUT a S_FALSE, la biblioteca de minivolcado enviará todas las E/S a través de devoluciones de llamada. El autor de la llamada realizará recibe una devolución de llamada ioWriteAllCallback para cada fragmento de datos. DbgHelp 6.4 y versiones anteriores: Este valor no se admite.
IoWriteAllCallback La devolución de llamada debe escribir todos los bytes solicitados o no. El miembro de Io del MINIDUMP_CALLBACK_INPUT estructura contiene la solicitud. Si se produce un error en la operación de escritura, la devolución de llamada debe devolver FALSE. Si el parámetro la operación de escritura se realiza correctamente, la devolución de llamada debe devolver TRUE y establecer la Miembro de estado de MINIDUMP_CALLBACK_OUTPUT a S_OK. El autor de la llamada recibirá una devolución de llamada de IoFinishCallback . cuando se ha completado la E/S. DbgHelp 6.4 y versiones anteriores: Este valor no se admite.
IoFinishCallback La devolución de llamada devuelve información de finalización de E/S. Si la devolución de llamada devuelve FALSE o no establece el miembro Status de MINIDUMP_CALLBACK_OUTPUT a S_OK, la biblioteca de minivolcados supone que se ha producido un error en la operación de escritura de minivolcado. DbgHelp 6.4 y versiones anteriores: Este valor no se admite.
ReadMemoryFailureCallback No se pudo leer la memoria. Si la devolución de llamada devuelve TRUE y establece el miembro Status de MINIDUMP_CALLBACK_OUTPUT a S_OK, se omite el error de memoria y el bloque se omite del minivolcado. De lo contrario, esto el error produce un error al escribir en el minivolcado. DbgHelp 6.4 y versiones anteriores: Este valor no se admite.
SecondaryFlagsCallback La devolución de llamada devuelve información secundaria. DbgHelp 6.5 y versiones anteriores: Este valor no se admite.
IsProcessSnapshotCallback La función de devolución de llamada indica si el destino es un proceso o una instantánea. DbgHelp 6.2 y versiones anteriores: Este valor no se admite.
VmStartCallback La función de devolución de llamada indica si el destinatario admite y acepta devoluciones de llamada de memoria virtual, como VmQueryCallback, VmPreReadCallback y VmPostReadCallback. Un valor devuelto de S_FALSE significa que se admiten devoluciones de llamada de memoria virtual. Un valor de S_OK significa que no se admiten devoluciones de llamada de memoria virtual. DbgHelp 6.2 y versiones anteriores: Este valor no se admite.
VmQueryCallback La función de devolución de llamada se invoca para que los destinos de instantánea recopilen información de memoria de direcciones virtuales del destino. Solo se llama a la devolución de llamada si VmStartCallback devolvió un valor de S_FALSE. DbgHelp 6.2 y versiones anteriores: Este valor no se admite.
VmPreReadCallback La función de devolución de llamada se envía para cada operación ReadVirtual. Estas lecturas no se limitan a los bloques de memoria que se agregan al volcado de memoria. El motor también tiene acceso al bloque de entorno de proceso (PEB), al bloque de entorno de subprocesos (TEB), a los datos del cargador, a los seguimientos del módulo descargado y a otros bloques. Incluso si esos bloques no terminan en el volcado de memoria, se leen desde el destino y se inician devoluciones de llamada de memoria virtual para cada uno. Solo se llama a la devolución de llamada si VmStartCallback devolvió S_FALSE. DbgHelp 6.2 y versiones anteriores: Este valor no se admite.
VmPostReadCallback La función de devolución de llamada permite al destinatario modificar el contenido del búfer con datos de otros orígenes, como una memoria caché, o realizar ofuscación. El búfer en este punto está lleno o parcialmente por VmPreReadCallback y por ReadProcessMemory. Solo se llama a la devolución de llamada si VmStartCallback devolvió S_FALSE. DbgHelp 6.2 y versiones anteriores: Este valor no se admite.

Requisitos

Requisito	Valor
Header	minidumpapiset.h (incluir DbgHelp.h)
Redistribuible	DbgHelp.dll 5.1 o posterior

Consulte también

MINIDUMP_CALLBACK_INPUT

MiniDumpCallback