Compartir a través de

enumeración MINIDUMP_CALLBACK_TYPE (minidumpapiset.h)

  • Artículo

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