mirror of
https://github.com/nomi-san/parsec-vdd.git
synced 2026-08-07 13:50:45 +00:00
Nguyen Duy
292 lines
13 KiB
Markdown
292 lines
13 KiB
Markdown
<br>
|
||
|
||
<p align="center">
|
||
<img src="https://i.imgur.com/dDUa6GH.png" width="64" height="64" />
|
||
<h1 align="center">parsec-vdd</h1>
|
||
<p align="center">
|
||
✨ Standalone <strong>Parsec Virtual Display</strong>
|
||
<br />
|
||
Create virtual display up to <strong>4K@240Hz</strong>
|
||
</p>
|
||
<p align="center">
|
||
<img src="https://img.shields.io/github/stars/nomi-san/parsec-vdd?style=for-the-badge&logo=github" />
|
||
<img src="https://img.shields.io/github/downloads/nomi-san/parsec-vdd/total?style=for-the-badge&label=Downloads" />
|
||
</p>
|
||
</p>
|
||
|
||
<br>
|
||
|
||
## ℹ About
|
||
|
||
This project demonstrates a standalone solution to create virtual displays by
|
||
using
|
||
[Parsec VDD](https://support.parsec.app/hc/en-us/articles/4422939339789-Overview-Prerequisites-and-Installation),
|
||
without relying on the [Parsec app](https://parsec.app/).
|
||
|
||
> The Virtual Display Driver (VDD) is required to enable virtual displays on a
|
||
> Windows host. Virtual displays is a feature available for **Teams** and
|
||
> **Warp** customers that lets you add up to 3 additional virtual displays to
|
||
> the host while connecting to a machine you own through Parsec.
|
||
|
||
> **Parsec VDD** is a perfect software driver developed by Parsec. It utilizes
|
||
> the
|
||
> [IddCx API](https://learn.microsoft.com/en-us/windows-hardware/drivers/display/indirect-display-driver-model-overview)
|
||
> (Indirect Display Driver) to create virtual displays on Windows 10+. This
|
||
> virtual display is particularly useful in situations where a physical monitor
|
||
> may not be available or when additional screens are desired.
|
||
|
||
> One of the notable features of Parsec VDD is its support for a wide range of
|
||
> [resolutions and refresh rates](#preset-display-modes), including up to 4K and
|
||
> 240 Hz. This makes it well-suited for gaming, as it can provide a high-quality
|
||
> visual experience. It enables users to simulate the presence of additional
|
||
> screens or work without a physical monitor, enhancing flexibility and
|
||
> customization in display management.
|
||
|
||
## 📺 ParsecVDisplay App
|
||
|
||
This is a complete driver application to control the Parsec VDD, written in C#
|
||
and WPF. It can show the number of virtual displays added, allows adding
|
||
multiple virtual displays and removing a specific selected one. Also allows to
|
||
change resolution and take screenshot, and more..
|
||
|
||
👉 Check out [Releases](https://github.com/nomi-san/parsec-vdd/releases) to
|
||
download it.
|
||
|
||
<p align="center">
|
||
<img src="https://github.com/nomi-san/parsec-vdd/assets/38210249/71b25bc6-eee1-4d80-94e0-e39eab7f8fb9" />
|
||
</p>
|
||
|
||
Full source code of this application is located in the [app](./app) folder.
|
||
|
||
## 🚀 Using Core API
|
||
|
||
### Design notes
|
||
|
||
Parsec VDD is designed to work with Parsec client-connection session. When user
|
||
connects to the host, the app will start controlling the driver, it sends IO
|
||
control codes and gets result. When adding a virtual display, you will get its
|
||
index to be used for unplugging, the maximum number of displays could be added
|
||
up to 16 per adapter. You have to ping to the driver periodically to keep added
|
||
displays alive, otherwise all of them will be unplugged after a second. There's
|
||
no direct way to manipulate added displays, you should call Win32 Display API to
|
||
change their display mode (see the ParsecVDisplay source).
|
||
|
||
```mermaid
|
||
flowchart LR
|
||
A(app)
|
||
B(vdd)
|
||
|
||
A <--->|ioctl| B
|
||
A ..->|ping| B
|
||
|
||
B --- X(display1)
|
||
B --- Y(display2)
|
||
B --- Z(display3)
|
||
|
||
winapi -->|manipulate| X
|
||
```
|
||
|
||
### Using the code
|
||
|
||
- The core API is designed as single C/C++ header that can be added to any
|
||
project, 👉 [core/parsec-vdd.h](./core/parsec-vdd.h)
|
||
- There is also a simple demo program, 👉 [core/vdd-demo.cc](./core/vdd-demo.cc)
|
||
|
||
### Picking a driver
|
||
|
||
You have to install the driver to make them work.
|
||
|
||
| Version | Minimum OS | IddCx | Notes |
|
||
| :---------------- | :-------------- | :---: | :-------------------------------------------------------- |
|
||
| [parsec-vdd-0.38] | Windows 10 1607 | 1.0 | Obsolete, may crash randomly. |
|
||
| [parsec-vdd-0.41] | Windows 10 19H2 | 1.4 | Stable. |
|
||
| [parsec-vdd-0.45] | Windows 10 21H2 | 1.5 | Better streaming color, but may not work on some Windows. |
|
||
|
||
[parsec-vdd-0.38]: https://builds.parsec.app/vdd/parsec-vdd-0.38.0.0.exe
|
||
[parsec-vdd-0.41]: https://builds.parsec.app/vdd/parsec-vdd-0.41.0.0.exe
|
||
[parsec-vdd-0.45]: https://builds.parsec.app/vdd/parsec-vdd-0.45.0.0.exe
|
||
|
||
> All of them also work on Windows Server 2019 or higher.
|
||
|
||
You can unzip (using 7z) the driver setup above to obtain the driver files and
|
||
`nefconw` CLI.
|
||
|
||
```
|
||
vdd-0.45/
|
||
|__ nefconw.exe
|
||
|__ driver/
|
||
|__ mm.cat
|
||
|__ mm.dll
|
||
|__ mm.inf
|
||
```
|
||
|
||
Command line method to install the driver using `nefconw` (admin required):
|
||
|
||
```
|
||
start /wait .\nefconw.exe --remove-device-node --hardware-id Root\Parsec\VDA --class-guid "4D36E968-E325-11CE-BFC1-08002BE10318"
|
||
start /wait .\nefconw.exe --create-device-node --class-name Display --class-guid "4D36E968-E325-11CE-BFC1-08002BE10318" --hardware-id Root\Parsec\VDA
|
||
start /wait .\nefconw.exe --install-driver --inf-path ".\driver\mm.inf"
|
||
```
|
||
|
||
In additional, you can run the driver setup in silent mode to install it
|
||
quickly.
|
||
|
||
```
|
||
.\parsec-vdd-0.45.0.0.exe /S
|
||
```
|
||
|
||
## 😥 Known Limitations
|
||
|
||
> This list shows the known limitations of Parsec VDD.
|
||
|
||
### 1. HDR support
|
||
|
||
Parsec VDD does not support HDR on its displays (see the EDID below).
|
||
Theoretically, you can unlock support by editing the EDID, then adding HDR
|
||
metadata and setting 10-bit+ color depth. Unfortunately, you cannot flash its
|
||
firmware like a physical device, or modify the registry value.
|
||
|
||
All IDDs have their own fixed EDID block inside the driver binary to initialize
|
||
the monitor specs. So the solution is to modify this block in the driver DLL
|
||
(mm.dll), then reinstall it with `nefconw` CLI (see above).
|
||
|
||
### 2. Custom resolutions
|
||
|
||
Before connecting, the virtual display looks in the
|
||
`HKEY_LOCAL_MACHINE\SOFTWARE\Parsec\vdd` registry for additional preset
|
||
resolutions. Currently this supports a maximum of 5 values.
|
||
|
||
```
|
||
SOFTWARE\Parsec\vdd
|
||
key: 0 -> 5 | (width, height, hz)
|
||
```
|
||
|
||
To unlock this limit, you need to patch the driver DLL the same way as above,
|
||
but **5 is enough** for personal use.
|
||
|
||
## 😑 Known Bugs
|
||
|
||
> This is a list of known issues when working with standalone Parsec VDD.
|
||
|
||
### 1. Incompatible with Parsec Privacy Mode
|
||
|
||
|
||
|
||
If you have enabled "Privacy Mode" in Parsec Host settings, please disable it
|
||
and clear the connected display configruations in the following Registry path.
|
||
|
||
```
|
||
HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\GraphicsDrivers\Connectivity
|
||
```
|
||
|
||
This option causes your main display to turn off when virtual displays are
|
||
added, making it difficult to turn the display on and disrupting the remote
|
||
desktop session.
|
||
|
||
### 2. // todo
|
||
|
||
## 🤔 Comparison with other IDDs
|
||
|
||
The table below shows a comparison with other popular Indirect Display Driver
|
||
projects.
|
||
|
||
| Project | Iddcx version | Signed | Gaming | HDR | H-Cursor | Tweakable | Controller |
|
||
| :----------------------------- | :-----------: | :----: | :----: | :-: | :------------------------------------------------------------------: | :-------: | :--------: |
|
||
| [usbmmidd_v2] | | ✅ | ❌ | ❌ | ❌ | | |
|
||
| [IddSampleDriver] | 1.2 | ❌ | ❌ | ❌ | ❌ | | |
|
||
| [RustDeskIddDriver] | 1.2 | ❌ | ❌ | ❌ | ❌ | | |
|
||
| [Virtual-Display-Driver (HDR)] | 1.10 | ❌ | | ✅ | ❌ | | |
|
||
| [virtual-display-rs] | 1.5 | ❌ | | ❌ | [#81](https://github.com/MolotovCherry/virtual-display-rs/issues/81) | ✅ | ✅ |
|
||
| parsec-vdd | 1.5 | ✅ | ✅ | ❌ | ✅ | 🆗 | ✅ |
|
||
|
||
✅ - full support, 🆗 - limited support
|
||
|
||
[usbmmidd_v2]: https://www.amyuni.com/forum/viewtopic.php?t=3030
|
||
[IddSampleDriver]: https://github.com/roshkins/IddSampleDriver
|
||
[RustDeskIddDriver]: https://github.com/fufesou/RustDeskIddDriver
|
||
[virtual-display-rs]: https://github.com/MolotovCherry/virtual-display-rs
|
||
[Virtual-Display-Driver (HDR)]: https://github.com/itsmikethetech/Virtual-Display-Driver
|
||
|
||
**Signed** means that the driver files have a valid digital signature.
|
||
**H-Cursor** means hardware cursor support, without it you will get double
|
||
cursor on some remote desktop apps. **Tweakable** is the ability to customize
|
||
display modes. Visit
|
||
[MSDN IddCx versions](https://learn.microsoft.com/en-us/windows-hardware/drivers/display/iddcx-versions)
|
||
to check the minimum supported Windows version.
|
||
|
||
## 📘 Parsec VDD Specs
|
||
|
||
### Preset display modes
|
||
|
||
All of the following display modes are set by driver default.
|
||
|
||
| Resolution | Common name | Aspect ratio | Refresh rates (Hz) |
|
||
| --------------- | :---------: | :----------------: | :------------------: |
|
||
| 4096 x 2160 | DCI 4K | 1.90:1 (256:135) | 24/30/60/144/240 |
|
||
| 3840 x 2160 | 4K UHD | 16:9 | 24/30/60/144/240 |
|
||
| 3840 x 1600 | UltraWide | 24:10 | 24/30/60/144/240 |
|
||
| 3840 x 1080 | UltraWide | 32:9 (2x 16:9 FHD) | 24/30/60/144/240 |
|
||
| 3440 x 1440 | | 21.5:9 (43:18) | 24/30/60/144/240 |
|
||
| 3240 x 2160 | | 3:2 | 60 |
|
||
| 3200 x 1800 | 3K | 16:9 | 24/30/60/144/240 |
|
||
| 3000 x 2000 | | 3:2 | 60 |
|
||
| 2880 x 1800 | 2.8K | 16:10 | 60 |
|
||
| 2880 x 1620 | 2.8K | 16:9 | 24/30/60/144/240 |
|
||
| 2736 x 1824 | | | 60 |
|
||
| 2560 x 1600 | 2K | 16:10 | 24/30/60/144/240 |
|
||
| 2560 x 1440 | 2K | 16:9 | 24/30/60/144/240 |
|
||
| 2560 x 1080 | UltraWide | 21:9 | 24/30/60/144/240 |
|
||
| 2496 x 1664 | | | 60 |
|
||
| 2256 x 1504 | | | 60 |
|
||
| 2048 x 1152 | | | 60/144/240 |
|
||
| 1920 x 1200 | FHD | 16:10 | 60/144/240 |
|
||
| **1920 x 1080** | **FHD** | **16:9** | 24/30/**60**/144/240 |
|
||
| 1800 x 1200 | FHD | 3:2 | 60 |
|
||
| 1680 x 1050 | HD+ | 16:10 | 60/144/240 |
|
||
| 1600 x 1200 | HD+ | 4:3 | 24/30/60/144/240 |
|
||
| 1600 x 900 | HD+ | 16:9 | 60/144/240 |
|
||
| 1440 x 900 | HD | 16:10 | 60/144/240 |
|
||
| 1366 x 768 | | | 60/144/240 |
|
||
| 1280 x 800 | HD | 16:10 | 60/144/240 |
|
||
| 1280 x 720 | HD | 16:9 | 60/144/240 |
|
||
|
||
Notes:
|
||
|
||
- Low GPUs, e.g GTX 1650 will not support the highest DCI 4K.
|
||
- All resolutions are compatible with 60 Hz refresh rates.
|
||
|
||
### Adapter info
|
||
|
||
- Name: `Parsec Virtual Display Adapter`
|
||
- Hardware ID: `Root\Parsec\VDA`
|
||
- Adapter GUID: `{00b41627-04c4-429e-a26e-0265cf50c8fa}`
|
||
- Class GUID: `{4d36e968-e325-11ce-bfc1-08002be10318}`
|
||
|
||
### Monitor info
|
||
|
||
- ID: `PSCCDD0`
|
||
- Name: `ParsecVDA`
|
||
- EDID:
|
||
|
||
```
|
||
00 FF FF FF FF FF FF 00 42 63 D0 CD ED 5F 84 00
|
||
11 1E 01 04 A5 35 1E 78 3B 57 E0 A5 54 4F 9D 26
|
||
12 50 54 27 CF 00 71 4F 81 80 81 40 81 C0 81 00
|
||
95 00 B3 00 01 01 86 6F 80 A0 70 38 40 40 30 20
|
||
35 00 E0 0E 11 00 00 1A 00 00 00 FD 00 30 A5 C1
|
||
C1 29 01 0A 20 20 20 20 20 20 00 00 00 FC 00 50
|
||
61 72 73 65 63 56 44 41 0A 20 20 20 00 00 00 10
|
||
00 00 00 00 00 00 00 00 00 00 00 00 00 00 01 C6
|
||
02 03 10 00 4B 90 05 04 03 02 01 11 12 13 14 1F
|
||
8A 4D 80 A0 70 38 2C 40 30 20 35 00 E0 0E 11 00
|
||
00 1A FE 5B 80 A0 70 38 35 40 30 20 35 00 E0 0E
|
||
11 00 00 1A FC 7E 80 88 70 38 12 40 18 20 35 00
|
||
E0 0E 11 00 00 1E A4 9C 80 A0 70 38 59 40 30 20
|
||
35 00 E0 0E 11 00 00 1A 02 3A 80 18 71 38 2D 40
|
||
58 2C 45 00 E0 0E 11 00 00 1E 00 00 00 00 00 00
|
||
00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 A6
|
||
```
|
||
|
||
Visit http://www.edidreader.com/ to view it online or use an advanced tool
|
||
[AW EDID Editor](https://www.analogway.com/apac/products/software-tools/aw-edid-editor/)
|