Método IDebugClient2::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 |
---|---|
|
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) |