vwemirror/riojoy
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Fix RioGamepad Code 31: add VHF lower filter + joy.cpl friendly name

Browse Source 
The driver installed but the device failed with Code 31
(CM_PROB_FAILED_ADD): VhfCreate returned STATUS_INVALID_DEVICE_REQUEST
(0xC0000010) because vhf.sys was never attached beneath the FDO. Add the
required LowerFilters=vhf AddReg to the INF so VHF loads as a lower
filter; the device now starts clean and enumerates in joy.cpl.

A VHF virtual HID device cannot supply a HID product string (VHF_CONFIG
has no string field and VHF owns IOCTL_HID_GET_STRING), so register the
DirectInput OEMName (VID_1209&PID_5249 -> RIOJoy Virtual Gamepad) in
install.ps1 -CreateDevice and remove it in uninstall.ps1, giving the
controller a proper name instead of the generic VHF default.

Also fix a non-ASCII em-dash in sign.ps1 that broke parsing under
Windows PowerShell 5.1 (UTF-8 without BOM), and document the Code 52 /
Code 31 / friendly-name troubleshooting in driver/README.md.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
This commit is contained in:
Cyd
2026-06-26 23:39:55 -05:00
co-authored by Claude Opus 4.8
parent 5dddbd2694
commit 38ffb27458
5 changed files with 101 additions and 7 deletions
Download Patch File Download Diff File Expand all files Collapse all files
driver/install.ps1
+22
View File
@@ -36,6 +36,27 @@ $cer = Join-Path $scriptDir "RIOJoyTest.cer"
$devgen = Join-Path $Ewdk "Program Files\Windows Kits\10\Tools\10.0.28000.0\x64\devgen.exe"
$hardwareId = "root\RioGamepad"
# DirectInput / joy.cpl friendly name. A VHF virtual HID device cannot supply a
# HID product string (VHF_CONFIG has no string field and VHF owns
# IOCTL_HID_GET_STRING), so without this the controller shows as the generic
# "Virtual HID Framework (VHF) HID device". DirectInput reads the display name
# from this OEMName value, keyed by VID/PID (see RioGamepad\Public.h:
# RIO_VENDOR_ID 0x1209 / RIO_PRODUCT_ID 0x5249).
$oemVidPid = "VID_1209&PID_5249"
$friendlyName = "RIOJoy Virtual Gamepad"
function Set-RioJoyFriendlyName {
# Write the OEMName under both HKLM (machine-wide, authoritative) and HKCU
# (immediate effect for the current user) so joy.cpl shows $friendlyName.
$rel = "SYSTEM\CurrentControlSet\Control\MediaProperties\PrivateProperties\Joystick\OEM\$oemVidPid"
foreach ($hive in @("HKLM:", "HKCU:")) {
$key = "$hive\$rel"
New-Item -Path $key -Force | Out-Null
New-ItemProperty -Path $key -Name "OEMName" -Value $friendlyName -PropertyType String -Force | Out-Null
}
Write-Host "Set joy.cpl friendly name for $oemVidPid -> '$friendlyName'."
}
if (-not ([Security.Principal.WindowsPrincipal][Security.Principal.WindowsIdentity]::GetCurrent()).IsInRole(
[Security.Principal.WindowsBuiltInRole]::Administrator)) {
throw "This script must be run from an elevated (Administrator) shell."
@@ -45,6 +66,7 @@ if ($CreateDevice) {
if (-not (Test-Path $devgen)) { throw "devgen not found: $devgen" }
Write-Host "Creating device node ($hardwareId)..."
& $devgen /add /instanceid "RIOJOY01" /hardwareid $hardwareId
Set-RioJoyFriendlyName
Write-Host ""
Write-Host "Done. Open 'joy.cpl' and look for 'RIOJoy Virtual Gamepad'." -ForegroundColor Green
Write-Host "If it shows a problem, check Device Manager and 'pnputil /enum-drivers'."