Метод IDebugClient::WriteDumpFile (dbgeng.h)
Метод WriteDumpFile создает файл дампа в пользовательском режиме или режиме ядра.
Синтаксис
HRESULT WriteDumpFile(
[in] PCSTR DumpFile,
[in] ULONG Qualifier
);
Параметры
[in] DumpFile
Указывает имя создаваемого файла дампа. DumpFile должен содержать расширение имени файла. DumpFile может содержать относительный или абсолютный путь; относительные пути относятся к каталогу, в котором был запущен отладчик.
[in] Qualifier
Указывает тип создаваемого файла дампа. Возможные значения см. в разделе Примечания.
Возвращаемое значение
Этот метод также может возвращать значения ошибок. Дополнительные сведения см. в разделе Возвращаемые значения .
Код возврата | Описание |
---|---|
|
Метод выполнен успешно. |
Комментарии
Константы DEBUG_DUMP_XXX используются методами WriteDumpFile, WriteDumpFile2 и WriteDumpFileWide , чтобы указать тип создаваемого файла аварийного дампа.
Возможные значения включают следующие.
Константа | Описание |
---|---|
DEBUG_DUMP_SMALL | Создает небольшой дамп памяти (режим ядра) или Minidump (режим пользователя). |
DEBUG_DUMP_DEFAULT | Создает дамп полного User-Mode (режим пользователя) или сводный дамп ядра (режим ядра). |
DEBUG_DUMP_FULL |
Создает полный дамп памяти (только в режиме ядра). |
Чтобы указать форматирование файла и (для минидампов пользовательского режима) сведения для включения в файл, используйте WriteDumpFile2 или WriteDumpFileWide.
Дополнительные сведения о файлах аварийных дампов см. в разделе Dump-File Targets.
Кроме того, для отладки в режиме ядра доступны следующие псевдонимы.
Псевдоним | Значение |
---|---|
DEBUG_KERNEL_SMALL_DUMP | DEBUG_DUMP_SMALL |
DEBUG_KERNEL_DUMP | DEBUG_DUMP_DEFAULT |
DEBUG_KERNEL_FULL_DUMP | DEBUG_DUMP_FULL |
Кроме того, для отладки в пользовательском режиме доступны следующие псевдонимы.
Псевдоним | Значение |
---|---|
DEBUG_USER_WINDOWS_SMALL_DUMP | DEBUG_DUMP_SMALL |
DEBUG_USER_WINDOWS_DUMP | DEBUG_DUMP_DEFAULT |
Описание файлов дампа в режиме ядра см. в разделе Варианты файлов дампа Kernel-Mode. Описание файлов дампа в пользовательском режиме см. в разделе Варианты файлов дампа User-Mode.
Требования
Требование | Значение |
---|---|
Целевая платформа | Персональный компьютер |
Верхняя часть | dbgeng.h (включая Dbgeng.h) |