专用虚拟显示屏 2880×1800 60Hz 150% HDR(高动态范围)独立可调,主屏不受联动干扰
现在
常用
截至 11 月 4 日 · 项目源码和驱动配置

Sunshine 远程串流 · 功能说明

需要时可以单独给 VDD 设 2880×1800、缩放与 HDR,不应该顺手改掉物理主屏;这里证明的是入口、保护逻辑和驱动配置内容,不是这次已经修改成功。

当前情况:已有独立调整虚拟屏参数、写前预检、写后回读和有条件回滚的功能。驱动配置文件里首选模式是 2880×1800@60,驱动的 HDRPlus 开关是关的;默认配置请求 HDR,但 Windows 这边的 HDR 实际开没开、现在是什么模式和缩放,没有新的回读。这次没有应用任何设置,手机画面和重启后是否保持仍未验收。

具体测试保留各自日期,页面不实时探测运行状态。

项目源码:私有仓库,源码未公开;用法与技术说明可在下面阅读。

专用虚拟显示屏 2880×1800 60Hz 150% HDR(高动态范围)独立可调,主屏不受联动干扰
现在
常用
截至 11 月 4 日 · 项目源码和驱动配置

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
  • 只查看还是应用改变
从开始到拿到结果
1只读认准虚拟屏
先看项目专用虚拟屏现在的画面大小、刷新率、缩放、HDR 状态和可选范围;主屏和其他小屏不进入修改范围。
2本人确认后才调整
按选定的清晰度、缩放和高动态范围设置预检,再应用;驱动不支持、显卡近期不安静或串流没空闲就停。
3回读真实显示
分别查看虚拟屏是否达到目标、主屏是否保持原样;配置成功仍需真实串流画面验收。
从哪里开始

用项目的 Set-SunshineVddDisplayProfile.ps1 先只读查看专用虚拟屏;确认目标模式后才显式使用 -Apply。正在串流时写入会被拦下,要等串流空闲。

需要准备什么
  • 想调整专用虚拟屏的分辨率、刷新率、缩放或 HDR
  • 只查看还是应用改变
从开始到拿到结果
1只读认准虚拟屏
先看项目专用虚拟屏现在的画面大小、刷新率、缩放、HDR 状态和可选范围;主屏和其他小屏不进入修改范围。
2本人确认后才调整
按选定的清晰度、缩放和高动态范围设置预检,再应用;驱动不支持、显卡近期不安静或串流没空闲就停。
3回读真实显示
分别查看虚拟屏是否达到目标、主屏是否保持原样;配置成功仍需真实串流画面验收。
技术实现与依据(一)

这里保留实现、关键条件、精确入口、历史记录和验证结果。

现存驱动配置(vdd_settings.xml):首项 2880×1800@60、HDRPlus 关闭。实际模式、缩放与 Windows HDR 截止前没有新的回读;9 月 18 日隔离测试回执保留,之后未重跑

关键规则与设计选择
1
项目初始 profile(配置组合)保留 2880×1800、60 Hz、150% 缩放与 HDR;后续显式调整可以覆盖。默认请求 HDR 不等于 Windows 里已经开了,实际开没开要回读才知道。
2
持久化首选项会把选定模式写在 VDD 驱动模式列表首位,目的是减少驱动重枚举时回退到 800×600;当前首项确为 2880×1800@60,但重枚举后是否保持仍未实测。
3
严格区分 Windows Advanced Color(高级颜色)/HDR 开关与 VDD 驱动内部的 12-bit HDRPlus 能力开关,避免概念混淆造成色彩异常;驱动配置里 HDRPlus 现在是关的,这和 Windows HDR 是两回事,32 位色深也不等于 10 位或 HDR 验收。
4
脚本默认只读:会读本地 VDD XML 和原生显示状态,但不写显示也不写文件;只有显式传入 -Apply,且显卡近期安静、串流连续空闲 5 秒、目标是同一个唯一 VDD、模式受支持、原值齐全时,才执行 Win32 变更与文件原子落盘。
当前怎样实现
  • 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 日隔离测试回执保留,之后未重跑

关键规则与设计选择
1
项目初始 profile(配置组合)保留 2880×1800、60 Hz、150% 缩放与 HDR;后续显式调整可以覆盖。默认请求 HDR 不等于 Windows 里已经开了,实际开没开要回读才知道。
2
持久化首选项会把选定模式写在 VDD 驱动模式列表首位,目的是减少驱动重枚举时回退到 800×600;当前首项确为 2880×1800@60,但重枚举后是否保持仍未实测。
3
严格区分 Windows Advanced Color(高级颜色)/HDR 开关与 VDD 驱动内部的 12-bit HDRPlus 能力开关,避免概念混淆造成色彩异常;驱动配置里 HDRPlus 现在是关的,这和 Windows HDR 是两回事,32 位色深也不等于 10 位或 HDR 验收。
4
脚本默认只读:会读本地 VDD XML 和原生显示状态,但不写显示也不写文件;只有显式传入 -Apply,且显卡近期安静、串流连续空闲 5 秒、目标是同一个唯一 VDD、模式受支持、原值齐全时,才执行 Win32 变更与文件原子落盘。
当前怎样实现
  • 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 日

技术实现与依据(二)
执行流程
1
用户或上层脚本调用入口并传入期望的宽高、刷新率、缩放与 HDR 模式。
2
脚本扫描系统显示设备,严格通过 MTT1337 硬件 ID、驱动绑定和 EDID 锁定专用虚拟屏,拒绝物理屏与水冷屏;临时的 DISPLAY 序号不当长期身份。
3
默认路径只回读身份、当前模式、支持模式、缩放与 HDR,不调用显示写 API。
4
若包含 -Apply,先过显卡、串流空闲和身份门,再调用 ChangeDisplaySettingsEx/CDS_TEST,随后才提交模式、用 DisplayConfigSetDeviceInfo 应用缩放与 HDR,并原子更新持久化 XML。
5
执行写后回读,确认生效参数与请求完全一致。
技术实现与依据(二)
执行流程
1
用户或上层脚本调用入口并传入期望的宽高、刷新率、缩放与 HDR 模式。
2
脚本扫描系统显示设备,严格通过 MTT1337 硬件 ID、驱动绑定和 EDID 锁定专用虚拟屏,拒绝物理屏与水冷屏;临时的 DISPLAY 序号不当长期身份。
3
默认路径只回读身份、当前模式、支持模式、缩放与 HDR,不调用显示写 API。
4
若包含 -Apply,先过显卡、串流空闲和身份门,再调用 ChangeDisplaySettingsEx/CDS_TEST,随后才提交模式、用 DisplayConfigSetDeviceInfo 应用缩放与 HDR,并原子更新持久化 XML。
5
执行写后回读,确认生效参数与请求完全一致。
名词和入口
本模块用到的名词
名词意思
CDS_TEST(显示设置预检)Win32 API 的安全测试标志;只验证系统能否接受该模式,不产生真实的屏幕闪烁或参数改动。
Advanced Color(高级颜色)Windows 官方的 HDR 渲染控制架构;只有在此处开启 HDR,系统才会向串流客户端输出宽色域信号。
专业定义

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

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

它把虚拟屏参数从物理主屏中拆开:先认准唯一 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。