BitBlt抓屏在RDP会话中黑屏或仅捕获部分窗口，是因为RDP默认禁用桌面合成，GetDC(GetDesktopWindow())获取的是隔离的虚拟桌面DC而非物理帧缓冲；正确做法是使用GetDC(NULL)获取系统共享表面DC，但须确保运行在交互式用户会话（Session ID > 0），且调用后立即ReleaseDC(NULL, hdc)防止DC泄漏。
Windows平台用BitBlt抓屏时为什么黑屏或只有部分窗口？
直接调用BitBlt从GetDesktopWindow()获取的DC截图，在远程桌面（RDP）会话中大概率黑屏或只捕到自己进程的窗口。这是因为RDP会话默认不启用“桌面合成”，GDI绘图目标被重定向到虚拟显示设备，而GetDC(GetDesktopWindow())拿到的是会话隔离后的桌面DC，不是物理帧缓冲。
正确做法是使用GetDC(NULL)获取全屏DC——它绕过窗口层级，直连系统显示驱动的共享表面（前提是会话有图形子系统权限）。但要注意：GetDC(NULL)在无用户登录的RDP服务会话（如Session 0）下仍会失败，必须确保代码运行在交互式用户会话中（Session ID > 0）。
- 验证当前会话：
WTSGetActiveConsoleSessionId()或WTSQuerySessionInformation()确认Session ID非0 - 不要用
FindWindow(L"Shell_TrayWnd")这类UI窗口做句柄依据，RDP下它们可能不可见或属于不同会话 -
BitBlt后立即ReleaseDC(NULL, hdc)，否则DC泄漏会导致后续截图变灰
怎么把截图数据传给远程客户端而不卡顿？
原始BITMAPINFO结构的RGB24位图体积大（1920×1080≈6MB），直接send()会严重阻塞网络线程。必须压缩，但别用Gdiplus::Bitmap::Save()走PNG/JPEG编码——它依赖COM初始化且耗CPU，远程桌面场景下容易触发GDI资源争用。
推荐用libjpeg-turbo做内存内JPEG压缩：先用GetDIBits()把HBITMAP转为连续BGR内存块（注意GDI默认是BGR顺序），再喂给tjCompress2()。压缩质量设60–75，平衡清晰度和吞吐量。
立即学习“C++免费学习笔记（深入）”；
- 避免每次截图都
tjInitCompress()：全局复用tjhandle，线程安全需加锁 - 压缩前做简单预处理：用
StretchBlt()缩放到目标分辨率（如1280×720），比高压缩率更省带宽 - 传输前加4字节长度头（
htonl(size)），客户端据此分配接收缓冲区，防止粘包
Linux下用X11截图为什么XGetImage()返回NULL？
在SSH + X11转发环境下，XOpenDisplay(NULL)常连到localhost:10.0这种虚拟显示，而真实桌面会话跑在:0。更关键的是，X11默认禁止非本地客户端读取屏幕（xhost策略限制），XGetImage()会因权限不足静默失败。
必须显式指定显示并检查权限：setenv("DISPLAY", ":0", 1)，再调用XOpenDisplay(NULL)；然后用XTestFakeKeyEvent()或检查/proc/*/environ确认当前进程是否属于同用户下的X session（UID匹配且DISPLAY一致）。
- 不要依赖
getenv("DISPLAY")——它可能被SSH转发污染，应从loginctl show-session $(loginctl | grep -m1 "session" | awk '{print $1}') -p Type确认session类型是"x11" -
XShmGetImage()比XGetImage()快5倍以上，但需XShmAttach()前检查XShmQueryExtension() - Wayland下原生不支持X11截图，必须用
xdg-desktop-portalD-Bus接口，C++需用gdbus或QtDBus调用
跨平台截图库选ffmpeg还是obs-studio？
ffmpeg的gdigrab（Windows）和x11grab（Linux）能直接对接帧缓冲，延迟低，但Windows下gdigrab在RDP会话中仍受限于GDI重定向问题；obs-studio底层用DirectX 11/12或XComposite，能拿到未合成前的原始帧，更适合远程桌面场景。
若集成obs-studio，重点不是调它的GUI，而是用obs_hotkey_register_frontend()和obs_source_get_type()构建无界面捕获源。Windows下强制启用dxgi-capture源，Linux下用xcomposite-input，避免走X11路径。
-
obs-studio需静态链接libobs，动态加载会因符号冲突崩溃（尤其与Qt混用时） - 不要用
avcodec_encode_video2()——FFmpeg已废弃，改用avcodec_send_frame()/avcodec_receive_packet()新API - 首次调用
obs_start_streaming()前必须obs_set_global_context()，否则日志里全是libobs: [error] ... invalid context
真正难的不是截哪一帧，而是让截图线程和网络发送线程对齐时间戳——RDP下帧率抖动大，硬编码100ms间隔必然丢帧。得用QueryPerformanceCounter()（Windows）或clock_gettime(CLOCK_MONOTONIC)（Linux）做自适应采样，根据上一帧实际耗时动态调整sleep。这个细节，八成人在测试时根本没碰上，直到上线后用户喊“画面卡成PPT”才回头翻。
