Método IDebugClient3::WriteDumpFile (dbgeng.h)
O método WriteDumpFile cria um arquivo de despejo de 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; 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.
Valor de retorno
Esse método também pode retornar valores de erro. Consulte de Valores Retornados para obter mais detalhes.
| Código de retorno | Descrição |
|---|---|
|
O método foi bem-sucedido. |
Observações
As constantes DEBUG_DUMP_XXX são usadas pelos métodos WriteDumpFile, WriteDumpFile2e WriteDumpFileWide para especificar o tipo de arquivo de despejo de falha a ser criado.
Os valores possíveis incluem o seguinte.
| Constante | Descrição |
|---|---|
| DEBUG_DUMP_SMALL | Cria um pequeno despejo de memória (modo kernel) ou 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 falhas, consulte Dump-File Targets.
Além disso, os aliases a seguir estão disponíveis para depuração no modo kernel.
| Cognome | 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.
| Cognome | 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.
Requisitos
| Requisito | Valor |
|---|---|
| da Plataforma de Destino | Área de trabalho |
| cabeçalho | dbgeng.h (inclua Dbgeng.h) |