【操作系统】Windows平台捕获崩溃现场底层原理，附代码亲测MiniDumpWriteDump

MiniDumpWriteDump 是一个Windows API函数，它属于DbgHelp.dll库，用于生成程序崩溃时的内存转储文件（MiniDump）。这个函数是Windows平台下用于捕获程序崩溃时的内存状态的常用方法之一。以下是MiniDumpWriteDump函数的原理和工作流程：

1. 函数调用：
   当程序崩溃时，操作系统会捕获到一个异常信号（如EXCEPTION_ACCESS_VIOLATION、EXCEPTION_INT_DIVIDE_BY_ZERO等），并根据配置决定是否生成转储文件。如果配置允许，操作系统会调用MiniDumpWriteDump函数。

2. 参数准备：
   MiniDumpWriteDump函数需要几个关键参数：

   • hProcess：表示要转储的进程的句柄。
   • ProcessId：表示要转储的进程的ID。
   • hFile：表示要写入转储数据的文件句柄。
   • DumpType：指定转储文件的类型，例如MiniDumpNormal、MiniDumpWithFullMemory、MiniDumpWithHandleData等。
   • ExceptionParam：指向异常信息的指针，如果是因为异常而生成转储文件，这个参数会提供异常的详细信息。
   • UserStreamParam：指向用户流信息的指针，可以用来添加额外的用户定义信息到转储文件中。
   • CallbackParam：指向回调函数的指针，如果提供了回调函数，它会在转储过程中被调用。

3. 内存转储：
   MiniDumpWriteDump函数会遍历进程的内存空间，根据DumpType参数的设置，决定哪些内存区域需要被转储。例如，如果设置了MiniDumpWithFullMemory，则会转储整个进程的内存空间；如果设置了MiniDumpWithHandleData，则会转储进程的句柄信息。

4. 文件写入：
   转储的数据会被写入到由hFile参数指定的文件中。这个文件就是最终生成的MiniDump文件，它包含了崩溃时的内存快照、寄存器状态、线程信息等。

5. 结束转储：
   当所有需要的数据都被写入文件后，MiniDumpWriteDump函数会返回，转储过程结束。

6. 后续处理：
   生成的MiniDump文件可以被开发者使用调试工具（如WinDbg）打开和分析，以帮助诊断程序崩溃的原因。

MiniDumpWriteDump函数是Windows平台上进行程序崩溃分析的重要工具，它允许开发者在程序崩溃时捕获到程序的完整状态，从而进行深入的调试和问题定位。

#include <windows.h>
#include <dbghelp.h>

void GenerateMiniDump(const char* dumpPath) {
    HANDLE hProcess = GetCurrentProcess();
    HANDLE hFile = CreateFile(dumpPath, GENERIC_WRITE, 0, NULL, CREATE_ALWAYS, FILE_ATTRIBUTE_NORMAL, NULL);
    if (hFile == INVALID_HANDLE_VALUE) {
        return;
    }

    MINIDUMP_EXCEPTION_INFORMATION mei;
    mei.ThreadId = GetCurrentThreadId();
    mei.ExceptionPointers = NULL;
    mei.ClientPointers = FALSE;

    MINIDUMP_USER_STREAM_INFORMATION musi;
    musi.UserStreamCount = 0;
    musi.UserStreamArray = NULL;

    MINIDUMP_CALLBACK_INFORMATION mci;
    mci.CallbackRoutine = NULL;
    mci.CallbackParam = NULL;

    BOOL result = MiniDumpWriteDump(hProcess, GetCurrentProcessId(), hFile, MiniDumpNormal, &mei, &musi, &mci);
    if (result) {
        // Dump file generated successfully
    } else {
        // Error occurred while generating the dump file
    }

    CloseHandle(hFile);
}