Skip to content

fix(driver): add Win10 WUDFRd driver path #93

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
ReenigneArcher merged 1 commit into from
Aug 19, 2026
+42 −9
Merged

fix(driver): add Win10 WUDFRd driver path #93

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
5 changes: 5 additions & 0 deletions docs/windows-driver.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -5,6 +5,11 @@ HID Framework. The driver package is separate from the normal C++ library build:
the library remains consumable from MSVC and MinGW/UCRT64, while the driver
package is built with the Microsoft SDK/WDK toolchain.

Windows 11 version 21H2 and later is the supported driver target. The INF also
provides a best-effort compatibility path for Windows 10 version 2004 and later
by using explicit `WUDFRd` service registration, but Windows 10 is not an
officially supported driver target.

## Microsoft Store Listing Text

The Windows driver package is not the same product surface as the C++ library,
Expand Down
46 changes: 37 additions & 9 deletions src/platform/windows/driver/libvirtualhid.inf.in
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -17,11 +17,16 @@ CatalogFile=libvirtualhid.cat
PnpLockdown=1

[Manufacturer]
%ManufacturerName%=Standard,NT@LIBVIRTUALHID_INF_ARCH@
; Windows 10 requires explicit WUDFRd service registration. Windows 11 can use
; the inbox WUDFRD.NT sections instead.
%ManufacturerName%=Standard,NT@LIBVIRTUALHID_INF_ARCH@.10.0...19041,NT@LIBVIRTUALHID_INF_ARCH@.10.0...22000

[Standard.NT@LIBVIRTUALHID_INF_ARCH@]
[Standard.NT@LIBVIRTUALHID_INF_ARCH@.10.0...19041]
%DeviceName%=DeviceInstall,ROOT\LIBVIRTUALHID

[Standard.NT@LIBVIRTUALHID_INF_ARCH@.10.0...22000]
%DeviceName%=DeviceInstall_Win11,ROOT\LIBVIRTUALHID

[DestinationDirs]
UMDriverCopy=13

Expand All @@ -33,13 +38,9 @@ libvirtualhid_umdf.dll=1

[DeviceInstall.NT]
CopyFiles=UMDriverCopy
Include=wudfrd.inf
Needs=WUDFRD.NT

[DeviceInstall.NT.HW]
AddReg=DeviceInstall_Device_AddReg,DeviceInstall_Vhf_AddReg
Include=wudfrd.inf
Needs=WUDFRD.NT.HW

[UMDriverCopy]
libvirtualhid_umdf.dll
Expand All @@ -52,20 +53,47 @@ HKR,,"LowerFilters",0x00010008,"vhf"
HKR,,VhfMode,0x00010001,0x1

[DeviceInstall.NT.Services]
AddService=WUDFRd,0x000001fa,WUDFRD_ServiceInstall

[DeviceInstall.NT.Wdf]
UmdfService=libvirtualhid_umdf,libvirtualhid_umdf_Install
UmdfServiceOrder=libvirtualhid_umdf
UmdfHostProcessSharing=ProcessSharingDisabled
UmdfHostPriority=PriorityHigh

[WUDFRD_ServiceInstall]
DisplayName=%WudfRdDisplayName%
ServiceType=1
StartType=3
ErrorControl=1
ServiceBinary=%12%\WUDFRd.sys

[DeviceInstall_Win11.NT]
CopyFiles=UMDriverCopy
Include=wudfrd.inf
Needs=WUDFRD.NT

[DeviceInstall_Win11.NT.HW]
AddReg=DeviceInstall_Device_AddReg,DeviceInstall_Vhf_AddReg
Include=wudfrd.inf
Needs=WUDFRD.NT.HW

[DeviceInstall_Win11.NT.Services]
Include=wudfrd.inf
Needs=WUDFRD.NT.Services

[DeviceInstall.NT.Wdf]
[DeviceInstall_Win11.NT.Wdf]
UmdfService=libvirtualhid_umdf,libvirtualhid_umdf_Install
UmdfServiceOrder=libvirtualhid_umdf
UmdfHostProcessSharing=ProcessSharingDisabled
UmdfHostPriority=PriorityHigh

[libvirtualhid_umdf_Install]
UmdfLibraryVersion=@LIBVIRTUALHID_UMDF_LIBRARY_VERSION@
UmdfHostProcessSharing=ProcessSharingDisabled
UmdfHostPriority=PriorityHigh
ServiceBinary=%13%\libvirtualhid_umdf.dll

[Strings]
ManufacturerName="LizardByte"
DiskName="libvirtualhid UMDF Driver Install Disk"
DeviceName="libvirtualhid Virtual HID Control Device"
WudfRdDisplayName="Windows Driver Foundation - User-mode Driver Framework Reflector"