
Sunshine 远程串流 · 功能说明
需要时可以单独给 VDD 设 2880×1800、缩放与 HDR,不应该顺手改掉物理主屏;这里证明的是入口、保护逻辑和驱动配置内容,不是这次已经修改成功。
当前情况:已有独立调整虚拟屏参数、写前预检、写后回读和有条件回滚的功能。驱动配置文件里首选模式是 2880×1800@60,驱动的 HDRPlus 开关是关的;默认配置请求 HDR,但 Windows 这边的 HDR 实际开没开、现在是什么模式和缩放,没有新的回读。这次没有应用任何设置,手机画面和重启后是否保持仍未验收。
具体测试保留各自日期,页面不实时探测运行状态。
项目源码:私有仓库,源码未公开;用法与技术说明可在下面阅读。


Sunshine 远程串流 · 功能说明
需要时可以单独给 VDD 设 2880×1800、缩放与 HDR,不应该顺手改掉物理主屏;这里证明的是入口、保护逻辑和驱动配置内容,不是这次已经修改成功。
当前情况:已有独立调整虚拟屏参数、写前预检、写后回读和有条件回滚的功能。驱动配置文件里首选模式是 2880×1800@60,驱动的 HDRPlus 开关是关的;默认配置请求 HDR,但 Windows 这边的 HDR 实际开没开、现在是什么模式和缩放,没有新的回读。这次没有应用任何设置,手机画面和重启后是否保持仍未验收。
具体测试保留各自日期,页面不实时探测运行状态。
项目源码:私有仓库,源码未公开;用法与技术说明可在下面阅读。


用途与实际影响
虚拟屏重启后可能退回很小的画面;普通显示工具又容易连带改动主屏。这个入口只认项目专用的虚拟屏,先查看它支持什么,再按本人选择调整。
“把手机用的虚拟屏调成我指定的清晰度和刷新率,别动家里主屏。”先只读查看当前值与驱动支持的可选模式(默认仍用 60 Hz,不强推最高刷新率);本人确认后才应用,并分别回读虚拟屏和主屏。
已得到独立参数入口、写前预检、写后回读与有条件的失败回滚,也能随时只读看到当前实际模式、缩放和 HDR 开没开;重枚举后的首选项保持和手机 HDR 画面仍未验收。

用途与实际影响
虚拟屏重启后可能退回很小的画面;普通显示工具又容易连带改动主屏。这个入口只认项目专用的虚拟屏,先查看它支持什么,再按本人选择调整。
“把手机用的虚拟屏调成我指定的清晰度和刷新率,别动家里主屏。”先只读查看当前值与驱动支持的可选模式(默认仍用 60 Hz,不强推最高刷新率);本人确认后才应用,并分别回读虚拟屏和主屏。
已得到独立参数入口、写前预检、写后回读与有条件的失败回滚,也能随时只读看到当前实际模式、缩放和 HDR 开没开;重枚举后的首选项保持和手机 HDR 画面仍未验收。

选定模式得到实际应用和读回;物理屏确实未受影响还要比较它的前后状态。
驱动不支持所选分辨率或刷新率时在修改前停止并说明可选模式。
认不出唯一的项目虚拟屏就拒绝修改任何显示器。

选定模式得到实际应用和读回;物理屏确实未受影响还要比较它的前后状态。
驱动不支持所选分辨率或刷新率时在修改前停止并说明可选模式。
认不出唯一的项目虚拟屏就拒绝修改任何显示器。

用项目的 Set-SunshineVddDisplayProfile.ps1 先只读查看专用虚拟屏;确认目标模式后才显式使用 -Apply。正在串流时写入会被拦下,要等串流空闲。
- 想调整专用虚拟屏的分辨率、刷新率、缩放或 HDR
- 只查看还是应用改变


用项目的 Set-SunshineVddDisplayProfile.ps1 先只读查看专用虚拟屏;确认目标模式后才显式使用 -Apply。正在串流时写入会被拦下,要等串流空闲。
- 想调整专用虚拟屏的分辨率、刷新率、缩放或 HDR
- 只查看还是应用改变


这里保留实现、关键条件、精确入口、历史记录和验证结果。
现存驱动配置(vdd_settings.xml):首项 2880×1800@60、HDRPlus 关闭。实际模式、缩放与 Windows HDR 截止前没有新的回读;9 月 18 日隔离测试回执保留,之后未重跑


- Set-SunshineVddDisplayProfile.ps1 负责参数校验与事务编排;sunshine-vdd-display-settings.psm1 负责身份、计划与 XML 候选。
- Get-SetVddDisplayMode.ps1 实现 ChangeDisplaySettingsEx/CDS_TEST 与模式回读;Get-SetVddScaleHdr.ps1 实现缩放和 Advanced Color(高级颜色)应用/回读,两者都有各自的独立恢复。
- tests/Test-SunshineVddDisplaySettings.ps1 现定义 19 个测试,Test-SunshineVddNativeAdapter.ps1 为静态核对,另有 Test-SunshineVddTransactions.ps1 定义 38 个事务测试。
- 完整VDD profile按命名参数哈希表分阶段执行实时模式、DPI/HDR及最终XML,每阶段都核对是不是同一块虚拟屏;完整预检先于效果,原值和回滚结果分别保存。回滚是有条件的:XML只回滚本次写入的版本,发现别处已经改过就保留对方的改动并报告“未恢复”,不保证任何失败都自动回到原样。回滚前重验GPU/会话/同一VDD,新增阻断保留未恢复项。

这里保留实现、关键条件、精确入口、历史记录和验证结果。
现存驱动配置(vdd_settings.xml):首项 2880×1800@60、HDRPlus 关闭。实际模式、缩放与 Windows HDR 截止前没有新的回读;9 月 18 日隔离测试回执保留,之后未重跑


- Set-SunshineVddDisplayProfile.ps1 负责参数校验与事务编排;sunshine-vdd-display-settings.psm1 负责身份、计划与 XML 候选。
- Get-SetVddDisplayMode.ps1 实现 ChangeDisplaySettingsEx/CDS_TEST 与模式回读;Get-SetVddScaleHdr.ps1 实现缩放和 Advanced Color(高级颜色)应用/回读,两者都有各自的独立恢复。
- tests/Test-SunshineVddDisplaySettings.ps1 现定义 19 个测试,Test-SunshineVddNativeAdapter.ps1 为静态核对,另有 Test-SunshineVddTransactions.ps1 定义 38 个事务测试。
- 完整VDD profile按命名参数哈希表分阶段执行实时模式、DPI/HDR及最终XML,每阶段都核对是不是同一块虚拟屏;完整预检先于效果,原值和回滚结果分别保存。回滚是有条件的:XML只回滚本次写入的版本,发现别处已经改过就保留对方的改动并报告“未恢复”,不保证任何失败都自动回到原样。回滚前重验GPU/会话/同一VDD,新增阻断保留未恢复项。
数字截至 2026 年 11 月 6 日




| 名词 | 意思 |
|---|---|
| CDS_TEST(显示设置预检) | Win32 API 的安全测试标志;只验证系统能否接受该模式,不产生真实的屏幕闪烁或参数改动。 |
| Advanced Color(高级颜色) | Windows 官方的 HDR 渲染控制架构;只有在此处开启 HDR,系统才会向串流客户端输出宽色域信号。 |

它把虚拟屏参数从物理主屏中拆开:先认准唯一 MTT1337,再回读,只在显式 Apply(应用)事务中预检并向 VDD 写入;物理屏不变要另做前后验收。



它把虚拟屏参数从物理主屏中拆开:先认准唯一 MTT1337,再回读,只在显式 Apply(应用)事务中预检并向 VDD 写入;物理屏不变要另做前后验收。

解决什么
降低虚拟显示器分辨率回退、HDR 色彩异常和多屏设置互相影响的风险。

- 入口绝不改写 Sunshine 的 output_name GUID 标识;所以调虚拟屏参数修不了“配置要抓的屏对不上”这类捕获问题。
- 绝对不触碰物理主屏(PHLC34B 等)、LIAN LI 水冷屏或 HS2 机箱副屏;主屏前后是否真的没变,仍要单独对照,源码测试代替不了。
- 不强行写入未经驱动支持的非标非常规显示模式;原生列出的高刷新档只说明驱动支持,能不能应用还要过参数校验和本人选择。
- 传入非法或未经支持的分辨率/刷新率 预检直接报错退出,不调用 Win32 写入 API,保持现有显示模式。
- 设备名被模拟或重命名为非安全格式 安全过滤层拒绝执行并抛出异常,防止向错误显示设备发送指令。
- XML 配置文件写入中途失败 只回滚本次写入的版本;如果发现文件已被别处改过,就保留对方的改动并明确报告未恢复,不硬盖回去。

解决什么
降低虚拟显示器分辨率回退、HDR 色彩异常和多屏设置互相影响的风险。

- 入口绝不改写 Sunshine 的 output_name GUID 标识;所以调虚拟屏参数修不了“配置要抓的屏对不上”这类捕获问题。
- 绝对不触碰物理主屏(PHLC34B 等)、LIAN LI 水冷屏或 HS2 机箱副屏;主屏前后是否真的没变,仍要单独对照,源码测试代替不了。
- 不强行写入未经驱动支持的非标非常规显示模式;原生列出的高刷新档只说明驱动支持,能不能应用还要过参数校验和本人选择。
- 传入非法或未经支持的分辨率/刷新率 预检直接报错退出,不调用 Win32 写入 API,保持现有显示模式。
- 设备名被模拟或重命名为非安全格式 安全过滤层拒绝执行并抛出异常,防止向错误显示设备发送指令。
- XML 配置文件写入中途失败 只回滚本次写入的版本;如果发现文件已被别处改过,就保留对方的改动并明确报告未恢复,不硬盖回去。

Set-SunshineVddDisplayProfile.ps1原生显示模式适配器入口
sunshine-vdd-display-settings.psm1设备身份、事务计划与 VDD XML 候选
Get-SetVddDisplayMode.ps1分辨率/刷新率 CDS_TEST、应用与回读
Get-SetVddScaleHdr.ps1缩放和 Windows HDR 原生应用与回读
tests/显示设置安全性与预检测试套件Test-SunshineVddDisplaySettings.ps1
- 9 月 18 日 14:07 原始回执:自动化测试 19/19 全部 PASS(覆盖参数校验、黑名单设备拦截、CDS_TEST 预检与原子持久化),事务组 38 项也通过;当时明确没有做真实模式、缩放、HDR 写入。现定义仍是 19 个,之后没有重跑。
- Test-SunshineVddNativeAdapter.ps1 静态核对预期 API 名称、禁止项与调用顺序;它没有真实调用 Win32 或改变显示。
- 现存驱动配置文件首项为 2880×1800@60、HDRPlus 关闭;这只是配置内容,不是 Apply 成功,也没有验证重枚举后是否保持、Windows HDR 状态或手机画面。
为 VDD 兜底提供独立、可回读的像素与色彩参数;是否真的改善手机画面仍由真实串流验收决定。

Set-SunshineVddDisplayProfile.ps1原生显示模式适配器入口
sunshine-vdd-display-settings.psm1设备身份、事务计划与 VDD XML 候选
Get-SetVddDisplayMode.ps1分辨率/刷新率 CDS_TEST、应用与回读
Get-SetVddScaleHdr.ps1缩放和 Windows HDR 原生应用与回读
tests/显示设置安全性与预检测试套件Test-SunshineVddDisplaySettings.ps1
- 9 月 18 日 14:07 原始回执:自动化测试 19/19 全部 PASS(覆盖参数校验、黑名单设备拦截、CDS_TEST 预检与原子持久化),事务组 38 项也通过;当时明确没有做真实模式、缩放、HDR 写入。现定义仍是 19 个,之后没有重跑。
- Test-SunshineVddNativeAdapter.ps1 静态核对预期 API 名称、禁止项与调用顺序;它没有真实调用 Win32 或改变显示。
- 现存驱动配置文件首项为 2880×1800@60、HDRPlus 关闭;这只是配置内容,不是 Apply 成功,也没有验证重枚举后是否保持、Windows HDR 状态或手机画面。
为 VDD 兜底提供独立、可回读的像素与色彩参数;是否真的改善手机画面仍由真实串流验收决定。
复制 AI 续作说明
项目:专用虚拟显示屏 2880×1800 60Hz 150% HDR(高动态范围)独立可调,主屏不受联动干扰;仓库:页面未提供仓库地址;范围:整个项目;目标:(这里写这次要做的事)。先读项目的 AGENTS.md 和说明,按现行规则做。
把“目标”换成这次要做的事,整段复制给 AI。







