通过

使用 WdbgExts 扩展回调

  • 项目

编写 WdbgExts 扩展 DLL 时，可以导出某些函数：

  • 必须导出名为 WinDbgExtensionDllInit 的函数。 当调试器加载扩展 DLL 时，它首先调用 WinDbgExtensionDllInit 并传递三个参数。

    • 指向 WINDBG_EXTENSION_APIS64 结构的指针，该结构包含指向由调试器实现并在 Wdbgexts.h 中声明的函数的指针。 必须将整个结构复制到在 DLL 中创建的全局变量。
    • 主版本号。 必须将主版本号复制到在 DLL 中创建的全局变量。
    • 次要版本号。 必须将次要版本号复制到在 DLL 中创建的全局变量。

    例如，可以创建名为 ExtensionApis、SavedMajorVersion 和 SavedMinorVersion 的全局变量，如以下示例所示。

    WINDBG_EXTENSION_APIS64 ExtensionApis;
USHORT SavedMajorVersion;
USHORT SavedMinorVersion;

VOID WinDbgExtensionDllInit(PWINDBG_EXTENSION_APIS64 lpExtensionApis,
    USHORT MajorVersion, USHORT MinorVersion)
{
   ExtensionApis = *lpExtensionApis;
   SavedMajorVersion = MajorVersion;
   SavedMinorVersion = MinorVersion;
    ...
}

  • 必须导出名为 ExtensionApiVersion 的函数。 调试器调用此函数，并返回指向包含扩展 DLL 版本号 的EXT_API_VERSION 结构的指针。 调试器在执行显示扩展版本号的 .chain 和 version 等命令时使用此版本号。

  • 可以选择导出名为 CheckVersion 的函数。 每次使用扩展命令时，调试器都会调用此例程。 如果 DLL 的版本与调试器略有不同，但差异不大，无法阻止其运行，则可以使用此来输出版本不匹配警告。