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

Artigo
02/23/2024

O método WriteDumpFile cria um arquivo de despejo do modo de usuário ou kernel-modecrash.

Sintaxe

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

Parâmetros

[in] DumpFile

Especifica o nome do arquivo de despejo a ser criado. DumpFile deve incluir a extensão de nome de arquivo. DumpFile pode incluir um caminho relativo ou absoluto; os caminhos relativos são relativos ao diretório no qual o depurador foi iniciado.

[in] Qualifier

Especifica o tipo de arquivo de despejo a ser criado. Para obter valores possíveis, consulte Comentários.

Retornar valor

Esse método também pode retornar valores de erro. Consulte Valores retornados para obter mais detalhes.

Código de retorno	Descrição
S_OK	O método foi bem-sucedido.

Comentários

As constantes DEBUG_DUMP_XXX são usadas pelos métodos WriteDumpFile, WriteDumpFile2 e WriteDumpFileWide para especificar o tipo de arquivo de despejo de memória a ser criado.

Os valores possíveis incluem o seguinte.

Constante	Descrição
DEBUG_DUMP_SMALL	Cria um Despejo de Memória Pequeno (modo kernel) ou Um Minidump (modo de usuário).
DEBUG_DUMP_DEFAULT	Cria um despejo de User-Mode completo (modo de usuário) ou despejo de resumo do kernel (modo kernel).
DEBUG_DUMP_FULL	Cria um Despejo de Memória Completo (somente no modo kernel).

Para especificar a formatação do arquivo e, para minidumps no modo de usuário, as informações a serem incluídas no arquivo, use WriteDumpFile2 ou WriteDumpFileWide.

Para obter mais informações sobre arquivos de despejo de memória, consulte Destinos de arquivo de despejo.

Além disso, os aliases a seguir estão disponíveis para depuração no modo kernel.

Alias	Valor
DEBUG_KERNEL_SMALL_DUMP	DEBUG_DUMP_SMALL
DEBUG_KERNEL_DUMP	DEBUG_DUMP_DEFAULT
DEBUG_KERNEL_FULL_DUMP	DEBUG_DUMP_FULL

Além disso, os aliases a seguir estão disponíveis para depuração no modo de usuário.

Alias	Valor
DEBUG_USER_WINDOWS_SMALL_DUMP	DEBUG_DUMP_SMALL
DEBUG_USER_WINDOWS_DUMP	DEBUG_DUMP_DEFAULT

Para obter uma descrição dos arquivos de despejo no modo kernel, consulte Variedades de arquivos de despejo de Kernel-Mode. Para obter uma descrição dos arquivos de despejo no modo de usuário, consulte Variedades de arquivos de despejo de User-Mode.