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

Статья
08/07/2023

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

Синтаксис

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

Параметры

[in] DumpFile

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

[in] Qualifier

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

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

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

Код возврата	Описание
S_OK	Метод выполнен успешно.

Константа	Описание
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.