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

Artículo
02/26/2024

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.