Dump-File Targets

Para obter uma introdução e visão geral dos arquivos de despejo de memória, consulte Arquivos de Despejo de Falha.

Abrindo arquivos de despejo

To open a crash dump file for use as a debugger target, use OpenDumpFile or OpenDumpfileWide. These methods are similar to the .opendump debugger command.

Note The engine doesn't completely attach to the dump file until the WaitForEvent method has been called. Quando um arquivo de despejo é criado a partir de um processo ou kernel, as informações sobre o último evento são armazenadas no arquivo de despejo. Depois que o arquivo de despejo for aberto, na próxima tentativa de execução, o mecanismo gerará esse evento para os retornos de chamada de evento. Só então o arquivo de despejo fica disponível na sessão de depuração. Consulte o modelo de execução e sessão de depuração para obter mais detalhes.

Arquivos adicionais podem ser usados para ajudar na depuração de um arquivo de despejo de memória. The methods AddDumpInformationFile and AddDumpInformationFileWide register files containing page-file information to be used when the next dump file is opened. Esses métodos devem ser chamados antes que o arquivo de despejo seja aberto. GetNumberDumpFiles will return the number of such files that were used when the current dump file was opened and GetDumpFile will return a description of these files.

Os arquivos de minidump no modo de usuário contêm vários fluxos de informações. These streams can be read using the Request operation DEBUG_REQUEST_READ_USER_MINIDUMP_STREAM.

Criando arquivos de despejo

To create a crash dump file of the current target -- user-mode or kernel-mode -- use WriteDumpFile2. This method is similar to the .dump debugger command.