一文讲透DDrawCompat：让老游戏在现代Windows上流畅运行的DirectDraw兼容方案

一文讲透DDrawCompat：让老游戏在现代Windows上流畅运行的DirectDraw兼容方案

【免费下载链接】DDrawCompatDirectDraw and Direct3D 1-7 compatibility, performance and visual enhancements for Windows Vista, 7, 8, 10 and 11项目地址: https://gitcode.com/gh_mirrors/dd/DDrawCompat

1998年的冬夜，你在奔腾II上第一次进入那款游戏，像素点阵的村庄、MIDI音乐、每秒24帧的感动。二十多年后，你翻出那张光盘，装进新电脑，双击图标——黑屏、花屏、报错"DirectDraw 初始化失败"，或者画面像坏掉的信号一样撕裂抖动。这不是游戏坏了，是它和你之间隔了二十多年的系统演进。DDrawCompat，一个以ddraw.dll形式存在的DirectDraw与Direct3D 1-7兼容性、性能与视觉增强工具，正是架在这道时间鸿沟上的桥。它不转换任何图形API，不重写渲染管线，而是让旧代码在现代Windows上"以为自己还在1998年"——同时把画面质量提升到2026年的水准。

先搞清楚：它到底"修"什么？

很多老游戏跑不起来的根源，不是显卡变弱了，而是系统"变脸"了。DirectDraw 时代遗留的接口在Vista之后基本处于半废弃状态：独占全屏切换失灵、调色板处理异常、垂直同步不可控、分辨率切换让桌面闪瞎眼、DPI缩放让画面糊成一团。DDrawCompat 做的是三件事：

• 修复：让DirectDraw/Direct3D 1-7的老调用按预期工作（能力位、色彩键、表面丢失恢复等）；
• 增强：加上原本没有的垂直同步、帧率限制、抗锯齿、分辨率缩放、显示滤镜；
• 兜底：部分修复GDI相关问题，让走GDI路径的游戏也能安稳运行。

一句话对比：没有它，游戏在"现代系统+老API"的夹缝里挣扎；有了它，游戏正常跑，画面还更好。而这一切，从你往游戏目录里丢一个文件开始。

第一站：游戏目录里那个多出来的 ddraw.dll

安装方式简单到有些粗暴：从发布页下载最新版压缩包，把ddraw.dll解压到游戏主程序（.exe）所在的目录。为什么是"放进去"而不是"装进系统"？因为Windows加载DLL时，优先从应用程序所在目录查找。游戏启动时调用DirectDrawCreate，系统先在游戏目录里找到你的ddraw.dll并加载它——DDrawCompat 就这样"不请自来"地进入了游戏进程。

来看看它进门后做了什么（源码在Dll/DllMain.cpp）：

1. 定位真身：从系统目录LoadLibrary加载真正的ddraw.dll，把它的导出函数全部记下来；
2. 防冲突：如果检测到已有其他DirectDraw包装器被加载，主动退出，不掺和；
3. 读配置：用Config::Parser::loadAllConfigFiles加载配置文件；
4. 开日志：按配置的日志级别初始化DDrawCompat-*游戏名*.log；
5. 装钩子：替换DirectDrawCreate、DirectDrawCreateEx等导出函数，随后在首次调用时创建真实的DirectDraw对象、保存原始vtable，再逐一安装全部hook。

这里有个关键细节：DDrawCompat 先调用系统原版函数拿到真实的DirectDraw对象，再通过SetCooperativeLevel建立合作层，然后才接管。它自始至终依赖原生库干活——这就是README里那句"没有任何API转换"的含义。它不是翻译官，是接线员。

第二站：话务员上线——vtable拦截是怎么回事

DirectDraw对象本质是一张函数指针表（vtable），游戏调用lpVtbl->Blt(...)本质是"跳到表里某个地址执行"。DDrawCompat 的做法是：把这张表复制一份存档（s_origVtable），然后把表里的函数指针替换成自己的版本，同时用VirtualProtect把表所在内存临时改成可写，改完再恢复保护属性。

// Common/CompatVtable.h（简化示意） template <typename Vtable> class CompatVtable { public: static void hookVtable(const Vtable& vtable, UINT version = 0) { memcpy(&s_origVtable, &vtable, vtableSize); // 存档原始函数表 VirtualProtect(&vtable, vtableSize, PAGE_READWRITE, &oldProtect); VtableHookVisitor<Vtable, Lock> visitor(vtable); forEach<Vtable>(visitor, version); // 逐项替换为hook函数 VirtualProtect(&vtable, vtableSize, oldProtect, &oldProtect); } };

每个被替换的函数在VtableHookVisitor::visit中登记，替换后的hookFunc会先打日志、加锁，然后调用真正的兼容函数（优先用项目自带的实现，没有就用存档的原始函数callOrigFunc）。整个替换发生在运行时，游戏进程自己的内存被修改，但磁盘上的游戏文件一个字节都没动。

把vtable hook想象成给游戏请了一位话务员：电话（API调用）打进来，话务员先记录、再转接。游戏根本不知道背后换了人，它只是"拨号"，然后听到该有的回应。之所以选这条路而不是直接改游戏二进制或静态重写API，是因为：改二进制既不优雅又脆弱，游戏更新或换版本就得重来；而hook方案对任何使用该接口的游戏通吃，还能在运行时按需开关。

第三站：表面与呈现——画面最后怎么上屏

DirectDraw的核心概念是"表面"（surface），游戏往表面画图，然后翻转（flip）或位块传输（Blt）到主表面。DDrawCompat 在DDraw/Surfaces/下用Surface、PrimarySurface、RealPrimarySurface等类把它们包了一层。

RealPrimarySurface是这站的主角。现代Windows没有真正的"独占主表面"概念，所以它管理一个隐藏的呈现窗口，把所有flip/Blt最终导向 DWM 合成器。它还顺手接管了几件现代系统才有的活儿：

• 帧率限制：getFpsLimiter()/waitForFlipFpsLimit在翻转前精确等待，配合FpsLimiter设置锁帧；
• Gamma校正：setGammaRamp把老游戏的伽马表作用到现代呈现链路；
• 丢失恢复：表面因切换窗口/锁屏而"丢失"时，restore自动恢复，游戏代码不用感知。

你可能会问：那 Direct3D 的老游戏（D3D1-7）呢？它们在Direct3d/目录下有另一套处理——设备、材质、纹理、顶点缓冲、视口各有各的适配层，比如Direct3dTexture.cpp负责纹理格式转换，Direct3dVertexBuffer.cpp决定顶点缓冲放系统内存还是显存（对应配置项VertexBufferMemoryType）。两条路径最终汇合到同一个出口：呈现给屏幕。

第四站：向下探底——与驱动和GDI的周旋

Blt/flip之后，画面要真正送到显示器。这一步在老系统上是驱动的事，在新系统上则由D3dDdi/目录的代码接管——它直接面对WDDM驱动接口，处理呈现（Present）、格式转换、用着色器做画面后处理。Shaders/目录里那些.hlsl文件（如AlphaBlend.hlsl、Lanczos.hlsl、CubicConvolution2.hlsl、ColorKey.hlsl）被D3dDdi/ShaderCompiler编译，实现显示滤镜、色彩键抠图、深度转换等效果。DisplayFilter 从 point/bilinear 到 lanczos、cubic convolution 的选项，就落在这里。

至于GDI，Gdi/目录处理的是那些用GDI画界面的游戏：光标、字体、调色板、滚动条、窗口过程……它修复了老GDI调用在现代系统上的种种错位，让"混合渲染"的游戏（一部分D3D、一部分GDI）也能画面统一。

到这里，一次Blt调用的完整旅程是：游戏代码 → 被hook的vtable → 兼容层处理（锁帧/滤镜/色彩键）→ 真实DirectDraw/GDI调用 → D3dDdi呈现 → 屏幕。这条路径上每个节点都可配置、可观测——这正是下一节的主题。

到这里你会问：怎么改它的行为？

DDrawCompat 的配置系统在Config/目录下，是一套类型安全的设置注册表：每个设置都是Setting的子类（如EnumSetting、IntSetting、BoolSetting、ListSetting），带名称、默认值、来源记录和可选参数。

// Config/Setting.h（结构示意） class Setting { public: virtual std::string getValueStr() const = 0; // 当前值 virtual bool load(const std::string& value) = 0; // 解析一行配置 const std::string& getName() const { return m_name; } void set(const std::string& value, const std::string& source); // 记录来源 };

配置写入游戏目录下的DDrawCompat.ini，一行一个键 = 值。所有设置项在启动时由Config::Parser加载，其中相当一部分还支持运行时通过游戏内覆盖层（overlay）动态调整——默认按Shift+F11（ConfigHotKey）打开配置窗口，改完立即生效，不用重启游戏。这就实现了"游戏跑起来之后再慢慢调"。

实战：三份可以直接抄的配置

场景一：1990年代末的2D像素游戏（暗黑类、星际类）

# DDrawCompat.ini —— 放在游戏exe同目录 SpriteDetection = on SpriteFilter = bilinear PalettizedTextures = on DisplayFilter = lanczos FpsLimiter = 60 VSync = on GdiInterops = all SurfacePatches = aggressive

效果：精灵放大后不再是一格一格的马赛克，调色板纹理渲染正确，帧率稳定在60。

场景二：早期3D游戏（古墓丽影初代、雷神之锤类）

ResolutionScale = 2x Antialiasing = msaa2x TextureFilter = anisotropic VertexBufferMemoryType = upload PresentDelay = on(10) ThreadPriorityBoost = high VertexFixup = gpu

效果：在4K屏上以两倍分辨率渲染再缩放到桌面，锯齿大幅减少，纹理清晰，顶点坐标精度问题被自动修正。

场景三：高分屏与多显示器

DpiAwareness = permonitor DisplayResolution = desktop FullscreenMode = borderless ViewportEdgeFix = aggressive SpriteAltPixelCenter = on AltTabFix = on

效果：全屏切换不再黑屏闪烁，DPI缩放不再发虚，Alt+Tab切出切入顺滑，副屏分辨率变化不再让游戏画面错位。

调参数的原则：一次只改一个。每改一项就进游戏验证，配合日志确认是否生效，而不是一次堆十个开关。

踩坑与排查：日志里藏着什么秘密

游戏目录下会生成DDrawCompat-游戏名.log。如果这个文件没出现，说明游戏根本没加载你的 ddraw.dll——常见原因是放错了目录，或者游戏实际运行的是系统目录里的原版DLL。日志级别默认info，想看得更细就把LogLevel = debug甚至trace写进ini。

日志能告诉你什么？

• 启动段：进程路径、DDrawCompat版本、Windows版本、配置加载结果；
• Hook段：Hooking function: ...列表，确认哪些接口被接管；
• 运行段：每个被hook的调用及其参数、返回值，LOG_FUNC/LOG_RESULT宏负责输出，嵌套调用会缩进显示，一眼看出调用链。

崩溃时配合CrashDump = full，会生成DDrawCompat-游戏名.dmp，里面记录了异常现场，报issue时附上它和info级日志，维护者基本就能定位问题。

内置的性能监控（StatsHotKey，默认Shift+F12）则回答"游戏到底卡在哪"：presentrate（呈现频率）、fliprate（翻转频率）、blitcount、lockcount（锁表面次数，过高说明CPU回读频繁），配合StatsColumns = cur, avg, min, max看瞬时值和趋势。比如lockcount居高不下，就该检查是不是某配置迫使表面常驻系统内存。

边界与取舍：它明确不做什么

DDrawCompat 的克制，是它稳定性的来源。README 白纸黑字列了不支持的范围，安装前先对号入座：

• 需要联网的游戏；Windows Insider 预览版；虚拟机/模拟环境（包括Wine）——不保证工作；
• 不要与其他包装器、hook、覆盖层、录屏软件叠加（不过FullscreenMode = borderless下桌面级录屏通常可以）；
• 混合其他图形API（DX8+、OpenGL、Vulkan、Glide）的应用——超出它的职责范围。

项目不接受Pull Request，新功能与bug修复统一走Issues反馈；同时只维护最新发布版。对开发者来说，它的代码库（C++，要求Visual Studio 2022+、Windows SDK/DDK）本身就是一份极好的兼容层设计教材，构建时可配合Git for Windows生成完整版本号。若你想本地构建或贡献反馈，克隆地址为https://gitcode.com/gh_mirrors/dd/DDrawCompat。

结语：技术连接过去与未来

回到1998年那个冬夜。DDrawCompat 做的，是把二十多年前的代码和今天的系统撮合在一起：vtable hook是它的耐心接线，INI配置是它的手术刀，日志是它的病历本，而Shaders/里那些着色器，是它给老画面补上的新时代滤镜。它不会让像素游戏变成3A大作，但会让那份存档继续读得下去，让那个村庄继续亮着灯。

在技术快速迭代的时代，兼容层是容易被忽视却不可或缺的存在。它连接着过去与未来，确保技术演进不会割裂我们的数字记忆——而这，正是这类项目最朴素也最珍贵的意义。

【免费下载链接】DDrawCompatDirectDraw and Direct3D 1-7 compatibility, performance and visual enhancements for Windows Vista, 7, 8, 10 and 11项目地址: https://gitcode.com/gh_mirrors/dd/DDrawCompat