简介这份资源面向使用 Visual C 进行游戏开发的程序员针对 DirectX 硬件加速环境下常规截屏键失效的问题提供一套可编译运行的截屏实现方案。当游戏通过 Direct3D 渲染并借助硬件覆盖层输出画面时系统级截图工具往往只能抓到黑屏或空白资源正是为解决这一痛点而整理。压缩包共 12 个文件约 22KB包含 4 个 h 头文件、2 个 cpp 源文件、2 个 ico 图标、1 个 rc 资源脚本、1 个 vcproj 工程文件、1 个 sln 解决方案及 1 个 txt 说明文档工程结构完整可直接用 Visual Studio 打开编译。其中源码演示了初始化 D3D 设备与交换链、复制帧缓冲区、转换位图格式并保存为图片文件的完整流程txt 文档则解释了硬件覆盖层导致抓屏失败的原因。目前已有 559 人学习适合希望掌握底层图形截屏技术、为游戏添加截图功能或调试画面输出的开发者参考。1. 为什么按 PrintScreen 抓不到 DirectX 游戏画面如果你做过游戏辅助工具或者录屏软件大概率遇到过这种玄学现象窗口化运行的游戏用 GDI 的BitBlt截出来一片漆黑全屏独占模式下更离谱截屏键按下去系统跟没听见一样。这不是你的代码写错了而是游戏走了 DirectX 的硬件加速渲染管线画面根本没经过 Windows 的 GDI 图层自然抓不到。这个资源包解决的正是这个问题。它是一套用 Visual C 写的 DirectX 截屏源码工程核心思路是绕过 GDI直接在 D3D 设备层面把后台缓冲区Back Buffer或交换链Swap Chain里的像素数据取出来再转成位图存盘。包里除了 SnapScreen 工程源码还附了一份关于 hardware overlay 硬件覆盖层导致抓屏失败的说明文档对理解「为什么抓不到」这件事很有帮助。适合两类人一是想给自己的游戏加截图功能的 C 开发者二是做录屏/辅助工具、需要稳定抓取 D3D 画面的工程师。2. DirectX 截屏的底层逻辑从交换链到像素缓冲2.1 为什么 GDI 截屏在 D3D 面前失效常规截屏走的是 GDI 路径GetDC拿到窗口设备上下文BitBlt把屏幕或窗口的像素拷到内存 DC再存成 BMP。这套流程在普通 Win32 窗口上没问题但 Direct3D 的呈现方式和 GDI 完全不是一回事。D3D 应用渲染时画面先画在后台缓冲区然后通过Present提交到前台。在全屏独占模式下前台缓冲直接由显卡扫描输出到显示器Windows 的桌面合成器根本不参与GDI 拿到的窗口区域是空的。窗口化模式下虽然经过 DWM 合成但 D3D 的交换链有自己的独立表面BitBlt抓到的往往只是窗口边框或者一片黑。更早的 hardware overlay 技术是另一个坑。视频播放器和部分老游戏会用 overlay 表面这块区域由显卡硬件直接叠加到最终输出上连 DWM 都不经过任何基于 GDI 或桌面合成的截屏手段都拿不到内容。包里那份 txt 文档讲的就是这个场景。2.2 交换链与后台缓冲区截屏的数据源头要抓到 D3D 画面得从交换链下手。D3D9 时代交换链由IDirect3DSwapChain9管理后台缓冲区可以通过GetBackBuffer拿到D3D11 则是IDXGISwapChain后台缓冲区用GetBuffer获取。拿到表面或纹理之后关键一步是把它变成 CPU 能读的内存数据。D3D9 的典型做法是GetRenderTargetData把默认池D3DPOOL_DEFAULT的渲染目标拷到一个系统内存池D3DPOOL_SYSTEMMEM的离屏表面然后LockRect锁定读取像素。D3D11 则用CopyResource把后台缓冲拷到一块D3D11_USAGE_STAGING的纹理再Map出来读。这里有个容易翻车的点后台缓冲区的格式通常是D3DFMT_A8R8G8B8或DXGI_FORMAT_B8G8R8A8_UNORM像素排列是 BGRA而 BMP 文件要求的是 BGR24 位或 BGRA32 位行序还是自下而上。直接 memcpy 存盘会得到颜色错乱或者上下颠倒的图必须做格式转换和行翻转。2.3 工程结构速览SnapScreen 里有什么解压后能看到完整的 VC 工程文件SnapScreen.sln是解决方案SnapScreen.vcproj是项目文件核心代码在SnapScreen.cpp和SnapScreen.h。stdafx.cpp、targetver.h是 VS 工程的标准预编译头配置Resource.h、SnapScreen.rc、small.ico、SnapScreen.ico是资源文件。整体是一个基于 Win32 窗口的 D3D 应用骨架截屏逻辑嵌在渲染循环里。文件作用SnapScreen.slnVS 解决方案入口SnapScreen.vcproj项目配置含链接器依赖SnapScreen.cpp主逻辑D3D 初始化、渲染循环、截屏实现SnapScreen.h类声明与常量定义stdafx.h / stdafx.cpp预编译头Resource.h / .rc图标等资源定义硬件覆盖层说明.txtoverlay 导致抓屏失败的原理说明3. 动手编译与核心截屏代码拆解3.1 环境准备与工程打开这套代码是 VC 工程格式.vcproj对应 Visual Studio 2008 到 2010 时代的项目结构。用 VS2019 或 VS2022 打开时IDE 会提示升级工具集点确认即可。如果编译报缺少d3dx9.h或d3d9.lib说明没装 DirectX SDK 或者 Windows SDK 版本不对。常见做法是装一个 DirectX SDKJune 2010 版本然后在项目属性里把 Include 和 Library 目录指过去。不过现在更省事的方案是直接用 Windows SDK 自带的 D3D 头文件把代码里的#include d3dx9.h换成#include d3d9.h去掉对 D3DX 扩展库的依赖。链接器输入里确保有d3d9.lib、dxguid.lib、winmm.lib。# 如果编译报 LNK2019 找不到 Direct3DCreate9 # 检查项目属性 - 链接器 - 输入 - 附加依赖项 # 确保包含以下库 d3d9.lib dxguid.lib上面是链接器配置的检查清单。d3d9.lib提供 D3D9 的导出函数dxguid.lib提供设备接口的 GUID 定义缺一不可。如果用的是 D3D11 方案对应换成d3d11.lib、dxgi.lib。3.2 初始化 D3D 设备与交换链截屏的前提是能拿到 D3D 设备。工程里的初始化流程大致是创建IDirect3D9对象调用CreateDevice创建IDirect3DDevice9同时配置D3DPRESENT_PARAMETERS定义交换链行为。// 初始化 D3D9 设备与交换链简化示意 IDirect3D9* pD3D Direct3DCreate9(D3D_SDK_VERSION); D3DPRESENT_PARAMETERS d3dpp {}; d3dpp.Windowed TRUE; d3dpp.SwapEffect D3DSWAPEFFECT_DISCARD; d3dpp.BackBufferFormat D3DFMT_A8R8G8B8; d3dpp.BackBufferWidth 800; d3dpp.BackBufferHeight 600; d3dpp.EnableAutoDepthStencil TRUE; d3dpp.AutoDepthStencilFormat D3DFMT_D24S8; IDirect3DDevice9* pDevice nullptr; pD3D-CreateDevice(D3DADAPTER_DEFAULT, D3DDEVTYPE_HAL, hWnd, D3DCREATE_SOFTWARE_VERTEXPROCESSING, d3dpp, pDevice);D3DSWAPEFFECT_DISCARD表示后台缓冲提交后内容丢弃这是最常见的模式。BackBufferFormat设为D3DFMT_A8R8G8B8保证有明确的像素格式可读。D3DDEVTYPE_HAL走硬件加速如果调试时显卡驱动有问题可以临时改成D3DDEVTYPE_REF用软件渲染排查。3.3 抓取后台缓冲区并保存为 BMP核心截屏函数分三步拿后台缓冲、拷到系统内存表面、锁内存写文件。// 截取后台缓冲区并保存为 BMP void CaptureBackBuffer(IDirect3DDevice9* pDevice, const char* filename) { IDirect3DSurface9* pBackBuffer nullptr; pDevice-GetBackBuffer(0, 0, D3DBACKBUFFER_TYPE_MONO, pBackBuffer); D3DSURFACE_DESC desc; pBackBuffer-GetDesc(desc); // 创建系统内存池的离屏表面 IDirect3DSurface9* pOffscreen nullptr; pDevice-CreateOffscreenPlainSurface(desc.Width, desc.Height, desc.Format, D3DPOOL_SYSTEMMEM, pOffscreen, nullptr); // 把后台缓冲数据拷到离屏表面 pDevice-GetRenderTargetData(pBackBuffer, pOffscreen); // 锁定内存读取像素 D3DLOCKED_RECT lockedRect; pOffscreen-LockRect(lockedRect, nullptr, D3DLOCK_READONLY); // 写 BMP 文件省略文件头构造核心是像素数据 // lockedRect.pBits 指向 BGRA 像素pitch 是行字节数 // 注意行序是自下而上写文件时需要翻转 pOffscreen-UnlockRect(); pOffscreen-Release(); pBackBuffer-Release(); }GetBackBuffer拿到的是默认内存池的表面CPU 不能直接读。CreateOffscreenPlainSurface创建一块系统内存池的表面作为中转。GetRenderTargetData完成从显存到内存的拷贝这一步是同步的会阻塞渲染管线所以不要在每帧都调用。LockRect返回的pBits就是像素数据起始地址Pitch是每行字节数可能大于宽度乘以像素字节数写文件时要按 Pitch 逐行拷贝不能直接一整块 memcpy。BMP 文件头构造部分需要填BITMAPFILEHEADER和BITMAPINFOHEADER像素数据按 BGR 顺序、自下而上排列。如果原始格式是 BGRA写 24 位 BMP 时要丢掉 Alpha 通道。4. 避坑与排查截屏黑屏、花屏、崩溃的常见原因4.1 截出来全黑或只有窗口边框现象保存的 BMP 打开后一片黑或者只有标题栏和边框游戏画面区域是空的。原因截屏时机不对或者抓错了表面。如果在Present之后才去读后台缓冲D3DSWAPEFFECT_DISCARD模式下内容已经被丢弃。另外如果游戏用的是 overlay 表面后台缓冲里根本没有画面数据。解决把截屏调用放在Present之前、渲染完成之后。对于 overlay 场景需要改用IDirect3DDevice9::GetFrontBufferData抓前台缓冲但这个接口在全屏模式下才能拿到完整画面窗口模式下会抓到整个桌面。4.2 图像颜色错乱或上下颠倒现象截出来的图能看但红色和蓝色对调了或者画面上下翻转。原因D3D 后台缓冲的像素格式是 BGRA而 BMP 期望的是 BGR 排列同时 D3D 的纹理坐标原点在左上角但 BMP 文件的行序是自下而上。解决写文件时逐行倒序写入从最后一行开始拷。颜色通道方面如果存 24 位 BMP按 B、G、R 顺序取字节跳过第四个 Alpha 字节。如果存 32 位 BMP直接按 BGRA 写入即可但要注意 BMP 的 32 位格式对 Alpha 通道的处理和 D3D 不完全一致。4.3 调用 GetRenderTargetData 返回 D3DERR_INVALIDCALL现象截屏函数返回失败HRESULT 是D3DERR_INVALIDCALL。原因源表面和目标表面的格式或尺寸不匹配或者源表面不是渲染目标。GetRenderTargetData要求源表面必须是D3DPOOL_DEFAULT的渲染目标目标表面必须是D3DPOOL_SYSTEMMEM且格式一致。解决检查CreateOffscreenPlainSurface时传入的格式是否和后台缓冲的desc.Format完全一致。如果后台缓冲是D3DFMT_X8R8G8B8离屏表面也必须用这个格式不能混用D3DFMT_A8R8G8B8。4.4 多线程截屏导致设备丢失或崩溃现象在渲染线程之外的线程调用截屏程序随机崩溃或者 D3D 设备进入丢失状态。原因D3D9 设备不是线程安全的所有对设备的调用必须在创建它的线程里执行。跨线程调用GetBackBuffer、GetRenderTargetData会引发未定义行为。解决截屏请求通过消息或标志位传递给渲染线程在渲染循环里统一处理。如果必须在别的线程触发用SetEvent通知渲染线程渲染线程在Present前检查标志并执行截屏。4.5 编译报错找不到 d3dx9.h现象VS 提示Cannot open include file: d3dx9.h。原因DirectX SDK 没有安装或者安装后没有在项目里配置包含目录。新版 Visual Studio 默认不带 D3DX 扩展库。解决要么装 DirectX SDK (June 2010) 并在项目属性里添加$(DXSDK_DIR)Include和$(DXSDK_DIR)Lib\x86要么把代码里对 D3DX 的依赖去掉改用原生 D3D9 接口。这套工程的核心截屏逻辑不依赖 D3DX去掉#include d3dx9.h和相关的 D3DX 函数调用即可。5. 进阶技巧让截屏代码适配 D3D11 与多格式输出5.1 从 D3D9 迁移到 D3D11 的关键差异D3D11 的截屏思路和 D3D9 一致但接口全换了。后台缓冲通过IDXGISwapChain::GetBuffer获取得到的是ID3D11Texture2D。不能直接 Lock需要创建一块D3D11_USAGE_STAGING的纹理作为中转用ID3D11DeviceContext::CopyResource拷贝然后Map读取。// D3D11 截屏核心步骤 ID3D11Texture2D* pBackBuffer nullptr; pSwapChain-GetBuffer(0, __uuidof(ID3D11Texture2D), (void**)pBackBuffer); D3D11_TEXTURE2D_DESC desc; pBackBuffer-GetDesc(desc); desc.Usage D3D11_USAGE_STAGING; desc.CPUAccessFlags D3D11_CPU_ACCESS_READ; desc.BindFlags 0; desc.MiscFlags 0; ID3D11Texture2D* pStaging nullptr; pDevice-CreateTexture2D(desc, nullptr, pStaging); pContext-CopyResource(pStaging, pBackBuffer); D3D11_MAPPED_SUBRESOURCE mapped; pContext-Map(pStaging, 0, D3D11_MAP_READ, 0, mapped); // mapped.pData 是像素数据mapped.RowPitch 是行字节数 pContext-Unmap(pStaging, 0);CopyResource要求源纹理和目标纹理的格式、尺寸完全一致所以desc直接从后台缓冲拿只改 Usage 和 CPUAccessFlags。RowPitch和 D3D9 的Pitch含义相同写文件时同样要逐行处理。D3D11 的像素格式通常是DXGI_FORMAT_B8G8R8A8_UNORM通道顺序和 D3D9 的 BGRA 一致。5.2 输出 PNG 而非 BMP集成 stb_image_writeBMP 文件体积大实际工具里更常用 PNG。集成stb_image_write.h这个单头文件库一行调用就能把内存像素写成 PNG。#define STB_IMAGE_WRITE_IMPLEMENTATION #include stb_image_write.h // 假设 data 是 BGRA 像素需要先转成 RGBA std::vectorunsigned char rgba(width * height * 4); for (int y 0; y height; y) { for (int x 0; x width; x) { int srcIdx y * pitch x * 4; int dstIdx (y * width x) * 4; rgba[dstIdx 0] data[srcIdx 2]; // R rgba[dstIdx 1] data[srcIdx 1]; // G rgba[dstIdx 2] data[srcIdx 0]; // B rgba[dstIdx 3] data[srcIdx 3]; // A } } stbi_write_png(screenshot.png, width, height, 4, rgba.data(), width * 4);stbi_write_png的最后一个参数是每行字节数传width * 4即可。注意 BGRA 到 RGBA 的通道交换以及行序问题——stb 期望的是自上而下如果 D3D 数据是自下而上需要先翻转行序再传入。5.3 验证截屏完整性的一个实用习惯截屏代码写完别只看文件能不能打开。我一般会做两步验证第一步用GetPixel或者直接读内存检查图像四个角和中心点的像素值确认不是全黑或全白第二步把截屏结果和游戏内实际画面做逐像素对比如果偏差超过阈值说明色彩空间转换有问题。还有一个血泪经验在窗口被遮挡、最小化或者切换分辨率之后截屏结果可能异常。测试时要把这些边界情况都走一遍。从那以后我每次写完截屏模块都强制在窗口化、全屏、遮挡、最小化恢复这四种状态下各截一张确认都正常才算过。希望帮到你。本文还有配套的精品资源点击获取
