应使用 screen-capture-recorder(scrc)虚拟设备替代 directx/graphics capture api 实现 windows 屏幕录制,它通过 directshow 提供 rgb24(实为 bgr 排列)视频流,需正确构建滤镜图、设置输出格式与时间戳同步,并严格释放 com 资源。

用 screen-capture-recorder 避免从零实现采集逻辑
Windows 上写屏幕录制,别碰 DirectX 或 Graphics Capture API 的底层采集——调试成本高、权限和兼容性坑多。直接用社区验证过的 screen-capture-recorder(SCRC)虚拟音频/视频设备,它把桌面帧转成标准 DirectShow 视频流,C++ 只需调用 COM 接口拉流即可。
实操建议:
- 下载官方
screen-capture-recorder-to-video-windows-free.exe安装包,勾选“Install Screen-Capture-Recorder”安装(会注册为 DirectShow Filter) - 在代码中用
ICaptureGraphBuilder2构建滤镜图,Source Filter 名必须是L"Screen-Capture-Recorder" - 注意:SCRC 默认输出格式是
MEDIASUBTYPE_RGB24,不是MEDIASUBTYPE_YUY2,硬编码 YUV 处理会崩溃 - 若提示
0x80040218 (VFW_E_NOT_FOUND),说明没正确安装或未以管理员权限运行(尤其 Win10/11 启用 UAC 时)
用 IMediaControl::Run() 启动录制前必须连接好所有 Filter
DirectShow 不是“启动就录”,而是先拓扑连接再运行。漏掉 Render Filter 或 File Writer Filter,IMediaControl::Run() 会静默失败,且不报错。
关键步骤:
- 用
ICaptureGraphBuilder2::SetOutputFileName()指定.avi输出路径,它会自动插入AVI Mux和File Writer - 手动添加
Null Renderer仅用于预览(调试用),正式录制时不要连它,否则帧率被拖垮 - 务必调用
IGraphBuilder::RenderStream()连接视频流,参数中pPinOut来自 SCRC 的 Output Pin,pPinIn是 AVI Mux 的 Input Pin - 检查返回值:
HRESULT为S_OK才代表连接成功;hr == VFW_S_NOPREVIEWPIN是正常警告,可忽略
IMediaSample::GetPointer() 拿到的内存布局是 BGR 而非 RGB
SCRC 输出的 RGB24 实际是 BGR 排列(即每个像素字节顺序为 Blue-Green-Red),OpenCV 或 FFmpeg 默认按 RGB 解析就会偏色。这不是 bug,是 Windows GDI 的历史约定。
处理方式:
- 用
cv::Mat构造时显式指定CV_8UC3+cv::COLOR_BGR2RGB转换,别依赖 imread 自动识别 - 若用
libavcodec编码,AVFrame->data[0]指向的 buffer 直接 memcpy 过去即可,但AVFrame->format必须设为AV_PIX_FMT_BGR24,否则 sws_scale 会乱码 - 避免用
memcpy手动翻转字节序——性能差且易出错,交给专用转换函数
停止录制时 IMediaControl::Stop() 后必须释放 Filter Graph
只调 Stop() 不释放资源,会导致下次录制失败(0x80070006 (ERROR_INVALID_HANDLE))、进程句柄泄漏,甚至卡死桌面。
必须做:
- 调用
IMediaControl::Stop()后,立刻调IGraphBuilder::Release()、ICaptureGraphBuilder2::Release()等所有 COM 接口指针的Release() - 用
CoUninitialize()结束 COM 库,否则多次启停后CoInitializeEx()可能返回RPC_E_CHANGED_MODE - 若录制中途异常退出(如用户 Ctrl+C),需在
SetConsoleCtrlHandler回调里补上上述清理逻辑,否则残留的 SCRC 设备锁会导致重启后无法再采集
真正麻烦的是时间戳同步和音频混流——那部分得切到 WASAPI 拉音频,再用 IMultiInputPin 或自定义 Muxer 对齐 PTS,不是加几行代码能搞定的。
C++免费学习笔记(深入):立即使用
在学习笔记中,你将探索 C++ 的入门与实战技巧!











