Hyper-V Guest Integration Drivers for Windows NT

Hyper-V integration services for Windows NT 3.5x and Windows NT 4.0, for any edition/service packs. This project is still experimental and instability should be expected. Only a subset of devices are currently supported, indicated below.

Why?

Why not?

Supported Hyper-V devices and services

• Heartbeat
• Synthetic display
  • Supports multiple resolutions, 16/32-bit color depths
• Synthetic mouse
• Synthetic network controller

Notes

• NT 4.0 will need CompatibilityForOlderOperatingSystemsEnabled set to $true, at least until SP6a is installed.
• CPUs for any version must be at 1, and the Standard PC HAL is currently required.
  • Press F5 during installation to select a HAL.
• Only Windows 11 25H2 has been tested as a host at this time, but older versions should function (eventually down to Server 2008). Only Generation 1 VMs are supported as NT does not support UEFI.

Driver installation

• Drivers can be installed either during setup or after installation from the built floppy disk image from GitHub Actions.
• The VMBus controller driver (floppy/vmbus directory) must be installed first using the Add/remove SCSI adapters option. If installing drivers during setup, install the VMBus controller driver during the storage adapter phase.
• All other drivers can be installed in any order, from their respective directories.
  • NT 4.0 must use the driver-specific .inf file for installation if present, otherwise use the oemsetup.inf file.

Building

• A current version of MSVC is required, along with CMake.
• The headers/libraries from the following are required:
  • MSVC 4.20
  • Windows NT 3.5 DDK
  • Windows NT 3.51 SDK
  • Windows NT 4.0 DDK
  • Windows NT 4.0 SDK
• Folder structure should appear like this:
  • /sdk-ddk
    • /msvc420
      • /inc
      • /lib
    • /nt4_ddk
      • /inc
      • /lib_i386
    • /nt4_sdk
      • /inc
      • /lib_i386
    • /nt35_ddk
      • /inc
      • /lib_i386
    • /nt351_sdk
      • /inc
      • /lib_i386

Credits

• Goldfish64 for this software
• Microsoft Hypervisor Top-Level Functional Specification
• MacHyperVSupport