36 lines
3.2 KiB
Markdown
36 lines
3.2 KiB
Markdown
# Windows仅保留2K主屏（2026-11-03）
|
||
|
||
用户条件：只有在不影响当前2K屏幕使用时才调整。已完成并读回：Windows仅一个活动桌面输出，保留Virtual Display Driver主屏2560×1440@60，盒子原Moonlight进程46934继续2K45/RKMPP/EGL，截图正常。GTX965M错误码0，Sunshine布局变化后仍创建h264_nvenc，最终编码占用10%。没有重启Windows/盒子、禁用显卡设备、卸载驱动或修改PVE/GPU直通。
|
||
|
||
## 调整前后
|
||
|
||
| 输出 | 原布局 | 现布局 |
|
||
| --- | --- | --- |
|
||
| DISPLAY4 / Virtual Display Driver | 主屏，2560×1440@60，坐标0,0 | 保留原模式和主屏身份，唯一活动输出 |
|
||
| DISPLAY1 / Microsoft Basic Display Adapter | 扩展屏，2560×1440@64，坐标-1024,1440 | 从Windows桌面布局停用 |
|
||
| DISPLAY2 / NVIDIA GTX965M直接输出 | 原本未激活 | 保持未激活；GPU本身仍正常用于硬件编码 |
|
||
|
||
这里的“停用”仅指显示输出不参与Windows扩展桌面。设备管理器仍保留显示适配器，Windows设置也可能列出未连接的输出，不能将此操作说成卸载了多余显卡或移除了所有显示设备条目。
|
||
|
||
本轮VDD编号已是DISPLAY4，早先DISPLAY3记录不能用于写死设备号。工具按唯一活动VDD动态选择，并在修改前强制核对它已是2560×1440@60主屏，不满足条件不修改。
|
||
|
||
## 实现与验证
|
||
|
||
新增`tools/set-single-vdi-display.ps1`，Query只查询；Apply先保存设备身份、模式、主屏、布局为XML，使用ChangeDisplaySettingsEx逐项暂存，最后一次提交停用其他活动输出。申请为当前用户保存布局；不添加持续守护或额外登录任务。读回若不是唯一VDD主屏或模式改变，立即尝试恢复本次原布局。已有备份拒绝覆盖。
|
||
|
||
新增`tools/run-single-vdi-display.py`，通过已有VM100代理，在当前已登录用户会话运行一次性任务。任务已删除，最终`probe_task_present=False`。初次Query编译因缺少System.Xml引用失败，未执行显示修改；补齐引用后查询、应用、独立再次查询均成功。
|
||
|
||
当前状态已经验证；未通过重启/重新登录检验持久性，以避免中断用户使用。原2K登录脚本仍动态选择VDD，未改分辨率策略。盒子原配置、显示守护和串流参数未修改。
|
||
|
||
复核时误使用了会持续运行的`nvidia-smi encodersessions`，读取超时后已按进程及父命令精确停止本次监视子进程，再以一次性查询确认GPU健康；没有终止Sunshine或用户应用。Sunshine日志中的16:57音频端点错误早于本次显示调整，不是本次产生的新故障。
|
||
|
||
## 回退和证据
|
||
|
||
Windows原布局备份：`C:\ProgramData\VDI\single-display-20261103\before.xml`。
|
||
|
||
如需恢复，使用`python tools/run-single-vdi-display.py Restore`。恢复前核对显示设备名称、ID和注册表Key，身份变更时拒绝套用旧布局；本轮没有为演示回退再次打断当前单屏状态。
|
||
|
||
证据目录`docs/evidence/single-display-20261103/`包含before、apply、独立after-query、显卡/编码健康查询及实际2560×1440桌面截图。
|
||
|
||
API依据：[Microsoft ChangeDisplaySettingsEx](https://learn.microsoft.com/en-us/windows/win32/api/winuser/nf-winuser-changedisplaysettingsexw)。
|