驱动安装排障指南

[qiin2333]

驱动安装排障指南

Sunshine Foundation 集成了两个自定义驱动：

• ZakoVDD — 虚拟显示器驱动（IddCx）
• ZakoVirtualMouse — 虚拟鼠标驱动（UMDF HID）

常见问题

1. 驱动安装失败

症状: 安装过程中提示驱动安装失败，或安装完成后设备管理器中看不到虚拟设备

解决方案:

1. 确认 Windows 版本 ≥ Windows 10 1903
2. 以管理员身份运行安装程序
3. 如果使用测试签名驱动，需要开启测试模式：

   bcdedit /set testsigning on

   然后重启电脑

2. 虚拟显示器 (ZakoVDD) 不工作

症状: 串流时 Moonlight 客户端黑屏或无法捕获画面

排查步骤:

1. 打开设备管理器 → 显示适配器，确认 ZakoVDD 存在且无感叹号
2. 检查显示设置中是否出现虚拟显示器
3. 确认 vdd_settings.xml 配置正确（分辨率/刷新率）
4. 尝试手动启用/禁用虚拟显示器

3. 虚拟鼠标 (ZakoVirtualMouse) 不工作

症状: 串流时鼠标移动异常或无法点击

排查步骤:

1. 打开设备管理器 → 人体学输入设备 (HID)，确认虚拟鼠标存在
2. 检查 Sunshine 日志中是否有 HID 相关错误
3. 确认没有其他虚拟鼠标驱动冲突

4. 驱动更新

新版本 Sunshine Foundation 会自动更新驱动。如需手动更新：

1. 在设备管理器中卸载旧驱动
2. 重新运行安装程序

---

如果以上步骤无法解决问题，请在下方附上：

1. Windows 版本信息
2. 设备管理器截图
3. Sunshine 日志文件