Método IDebugClient3::WriteDumpFile (dbgeng.h)

El método WriteDumpFile crea un archivo de volcado de memoria en modo de usuario o kernel-modecrash.

Sintaxis

HRESULT WriteDumpFile(
  [in] PCSTR DumpFile,
  [in] ULONG Qualifier
);

Parámetros

[in] DumpFile

Especifica el nombre del archivo de volcado de memoria que se va a crear. DumpFile debe incluir la extensión de nombre de archivo. DumpFile puede incluir una ruta de acceso relativa o absoluta; las rutas de acceso relativas son relativas al directorio en el que se inició el depurador.

[in] Qualifier

Especifica el tipo de archivo de volcado que se va a crear. Para obtener los valores posibles, vea Comentarios.

Valor devuelto

Este método también puede devolver valores de error. Consulte Valores devueltos para obtener más detalles.

Código devuelto Descripción
S_OK
Método realizado correctamente.

Comentarios

Los métodos WriteDumpFile, WriteDumpFile2 y WriteDumpFileWide usan las constantes DEBUG_DUMP_XXX para especificar el tipo de archivo de volcado de memoria que se va a crear.

Los valores posibles incluyen lo siguiente.

Constante Descripción
DEBUG_DUMP_SMALL Crea un volcado de memoria pequeño (modo kernel) o Minidump (modo de usuario).
DEBUG_DUMP_DEFAULT Crea un volcado de memoria de User-Mode completo (modo de usuario) o volcado de resumen del kernel (modo kernel).
DEBUG_DUMP_FULL

Crea un volcado de memoria completo (solo en modo kernel).

 

Para especificar el formato del archivo y,para minivolcados en modo de usuario, la información que se va a incluir en el archivo, use WriteDumpFile2 o WriteDumpFileWide.

Para obtener más información sobre los archivos de volcado de memoria, vea Destinos de archivo de volcado de memoria.

Además, los siguientes alias están disponibles para la depuración en modo kernel.

Alias Valor
DEBUG_KERNEL_SMALL_DUMP DEBUG_DUMP_SMALL
DEBUG_KERNEL_DUMP DEBUG_DUMP_DEFAULT
DEBUG_KERNEL_FULL_DUMP DEBUG_DUMP_FULL
 

Además, los siguientes alias están disponibles para la depuración en modo de usuario.

Alias Valor
DEBUG_USER_WINDOWS_SMALL_DUMP DEBUG_DUMP_SMALL
DEBUG_USER_WINDOWS_DUMP DEBUG_DUMP_DEFAULT
 

Para obtener una descripción de los archivos de volcado en modo kernel, consulte Variedades de Kernel-Mode archivos de volcado de memoria. Para obtener una descripción de los archivos de volcado en modo de usuario, vea Variedades de User-Mode archivos de volcado de memoria.

Requisitos

Requisito Value
Plataforma de destino Escritorio
Encabezado dbgeng.h (include Dbgeng.h)

Consulte también

.dump (Crear archivo de volcado)

IDebugClient

IDebugClient2

IDebugClient3

IDebugClient4

IDebugClient5

WriteDumpFile2

WriteDumpFileWide