IDebugClient3：：WriteDumpFile 方法 (dbgeng.h)
WriteDumpFile 方法创建用户模式或内核模式crash 转储文件。
语法
HRESULT WriteDumpFile(
[in] PCSTR DumpFile,
[in] ULONG Qualifier
);
参数
[in] DumpFile
指定要创建的转储文件的名称。 DumpFile 必须包含文件扩展名。 DumpFile 可以包含相对路径或绝对路径;相对路径相对于启动调试器的目录。
[in] Qualifier
指定要创建的转储文件的类型。 有关可能的值，请参阅备注。
返回值
此方法也可能返回错误值。 有关更多详细信息 ，请参阅返回值 。
| 返回代码 | 说明 |
|---|---|
|
方法成功。 |
注解
WriteDumpFile、WriteDumpFile2 和 WriteDumpFileWide 方法使用 DEBUG_DUMP_XXX 常量来指定要创建的故障转储文件类型。
可能的值包括以下内容。
| 一直 | 说明 |
|---|---|
| DEBUG_DUMP_SMALL | (内核模式) 或小型转储 (用户模式) 创建小型内存转储。 |
| DEBUG_DUMP_DEFAULT | 创建完全 User-Mode 转储 (用户模式) 或内核摘要转储 (内核模式) 。 |
| DEBUG_DUMP_FULL |
创建 (仅限内核模式) 的完整内存转储。 |
若要指定文件的格式以及要包含在文件中的用户模式小型转储的信息，请使用 WriteDumpFile2 或 WriteDumpFileWide。
有关故障转储文件的详细信息，请参阅 转储文件目标。
此外，以下别名可用于内核模式调试。
| Alias | 值 |
|---|---|
| DEBUG_KERNEL_SMALL_DUMP | DEBUG_DUMP_SMALL |
| DEBUG_KERNEL_DUMP | DEBUG_DUMP_DEFAULT |
| DEBUG_KERNEL_FULL_DUMP | DEBUG_DUMP_FULL |
此外，以下别名可用于用户模式调试。
| Alias | 值 |
|---|---|
| DEBUG_USER_WINDOWS_SMALL_DUMP | DEBUG_DUMP_SMALL |
| DEBUG_USER_WINDOWS_DUMP | DEBUG_DUMP_DEFAULT |
有关内核模式转储文件的说明，请参阅 Kernel-Mode 转储文件的品种。 有关用户模式转储文件的说明，请参阅 User-Mode 转储文件的品种。
要求
| 要求 | 值 |
|---|---|
| 目标平台 | 桌面 |
| 标头 | dbgeng.h (包括 Dbgeng.h) |