Метод IDebugClient2::WriteDumpFile (dbgeng.h)

Статья
02/06/2025

Метод WriteDumpFile создает файл дампа в режиме пользователя или в режиме ядра.

Синтаксис

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

Параметры

[in] DumpFile

Указывает имя создаваемого файла дампа. DumpFile должны включать расширение имени файла. DumpFile может включать относительный или абсолютный путь; относительные пути относятся к каталогу, в котором был запущен отладчик.

[in] Qualifier

Указывает тип создаваемого файла дампа. Возможные значения см. в разделе "Примечания".

Возвращаемое значение

Этот метод также может возвращать значения ошибок. Дополнительные сведения см. в возвращаемых значений.

Возвращаемый код	Описание
S_OK	Метод был успешным.

Замечания

Константы DEBUG_DUMP_XXX используются методами WriteDumpFile, WriteDumpFile2и WriteDumpFileWide, чтобы указать тип создаваемого файла дампа аварийного дампа.

Возможные значения включают следующие значения.

Постоянный	Описание
DEBUG_DUMP_SMALL	Создает небольшой дамп памяти (режим ядра) или Minidump (режим пользователя).
DEBUG_DUMP_DEFAULT	Создает полный User-Mode дамп (режим пользователя) или сводный дамп ядра (режим ядра).
DEBUG_DUMP_FULL	Создает дамп полной памяти (только в режиме ядра).

Чтобы указать форматирование файла и -for user-mode minidumps-сведения для включения в файл, используйте WriteDumpFile2 или WriteDumpFileWide.

Дополнительные сведения о файлах аварийного дампа см. в разделе Dump-File Целевые объекты.

Кроме того, для отладки в режиме ядра доступны следующие псевдонимы.

Псевдоним	Ценность
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.