Virtual Display Driver

based on Microsoft Indirect Display Driver Sample.

Supports emulating resolutions from 640 x 480 to 7680 x 4320 (8K), and refresh rates including 60hz and 120hz.

This project uses the official Windows Indirect Display Driver combined with the IddCx class extension driver.

Installation

1. Download the latest version from the releases page, and extract the contents to a folder.
2. Copy option.txt to C:\IddSampleDriver\option.txt before installing the driver (important!).
3. Right click and run the *.bat file as an Administrator to add the driver certificate as a trusted root certificate.
4. Don't install the inf. Open device manager, click on any device, then click on the "Action" menu and click "Add Legacy Hardware".
5. Select "Add hardware from a list (Advanced)" and then select Display adapters
6. Click "Have Disk..." and click the "Browse..." button. Navigate to the extracted files and select the inf file.
7. You are done! Go to display settings to customize the resolution of the additional displays. These displays show up in Sunshine, your Oculus or VR settings, and should be able to be streamed from.
8. You can enable/disable the display adapter to toggle the monitors.

Resolutions:

Aspect Ratio 16:9 (Widescreen):

1280 x 720
1360 x 768
1366 x 768
1600 x 900
1920 x 1080
2560 x 1440
2880 x 1620
3008 x 1692
3840 x 2160
4096 x 2304
5120 x 2880
6016 x 3384
7680 x 4320

Aspect Ratio 16:10:

1280 x 800
1440 x 900
1680 x 1050
1920 x 1200
2560 x 1600
2880 x 1800
3200 x 2400
3840 x 2400

Aspect Ratio 4:3:

640 x 480
800 x 600
1024 x 768
1152 x 864
1280 x 768
1280 x 960
1280 x 1024
1400 x 1050
1440 x 1440
1600 x 1024

Refresh Rates:

60Hz
120Hz

Background reading

Start at the Indirect Display Driver Model Overview on MSDN.

Customizing the sample

The sample driver code is very simplistic and does nothing more than enumerate a single monitor when its device enters the D0/started power state. Throughout the code, there are TODO blocks with important information on implementing functionality in a production driver.

Code structure

• Direct3DDevice class
  • Contains logic for enumerating the correct render GPU from DXGI and creating a D3D device.
  • Manages the lifetime of a DXGI factory and a D3D device created for the render GPU the system is using to render frames for your indirect display device's swap-chain.
• SwapChainProcessor class
  • Processes frames for a swap-chain assigned to the monitor object on a dedicated thread.
  • The sample code does nothing with the frames, but demonstrates a correct processing loop with error handling and notifying the OS of frame completion.
• IndirectDeviceContext class
  • Processes device callbacks from IddCx.
  • Manages the creation and arrival of the sample monitor.
  • Handles swap-chain arrival and departure by creating a Direct3DDevice and handing it off to a SwapChainProcessor.

License

MIT and CC0 or Public Domain (for changes I made, please consult Microsoft for their license), choose the least restrictive option.

Disclaimer:

This software is provided "AS IS" with NO IMPLICIT OR EXPLICIT warranty. It's worth noting that while this software functioned without issues on my system, there is no guarantee that it will not impact your computer. It operates in User Mode, which reduces the likelihood of causing system instability, such as the Blue Screen of Death. However, exercise caution when using this software.

Acknowledgements

Shoutout to Roshkins for the original repo: https://github.com/roshkins/IddSampleDriver

Microsoft Indirect Display Driver/Sample (Driver code): https://github.com/microsoft/Windows-driver-samples/tree/master/video/IndirectDisplay

Thanks to https://github.com/akatrevorjay/edid-generator for the hi-res EDID.