HzConfiguration - Monitor Refresh Rate Manager

Portable DLL for changing monitor refresh rates on Windows (Intel, NVIDIA, AMD, DisplayLink).

Features

• Portable: No installation required, works on any Windows 10/11
• Universal: Supports all GPU types (Intel, NVIDIA, AMD, DisplayLink)
• Simple API: Single method call to change all monitors
• Safe: Validates modes before applying changes
• No Dependencies: Uses built-in Windows API only

---

Quick Start

Option 1: Use Hertz.ps1 (Easiest)

The Hertz.ps1 script automatically loads the DLL from C:\Local\MonitorFix\deploy\MonitorFix\deploy\Files and sets the refresh rate:

# Set all monitors to 60 Hz
.\Hertz.ps1 60

# Set all monitors to 144 Hz
.\Hertz.ps1 144

Note: The DLL must be in C:\Local\MonitorFix\deploy\MonitorFix\deploy\Files\DisplayUtilLive.dll (see Build section below).

Option 2: Use DLL Directly

# Load DLL from C:\Local\MonitorFix\deploy\MonitorFix\deploy\Files
Add-Type -Path "C:\Local\MonitorFix\deploy\MonitorFix\deploy\Files\DisplayUtilLive.dll"

# View current configuration
[DisplayUtilLive]::GetCurrentStatus()

# Change all monitors to 60 Hz
[DisplayUtilLive]::SetAllMonitorsTo(60)

Option 3: Build from Source

PowerShell (no VS required):

.\Build-DLL.ps1

Batch:

Build.bat

Visual Studio:

1. Open DisplayUtilLive.sln
2. Build → Build Solution (Ctrl+Shift+B)

Note: All build methods automatically copy the DLL to:

• .\bin\DisplayUtilLive.dll (local build output)
• C:\Local\MonitorFix\deploy\MonitorFix\deploy\Files\DisplayUtilLive.dll (portable deployment location)

---

Files

HzConfiguration/
├── bin/
│   └── DisplayUtilLive.dll         # Compiled DLL (build output)
├── baramundi/                      # baramundi-ready scripts
│   ├── 01_registry.ps1             # DisplayLink registry setup
│   ├── 02_gpu_change.ps1           # GPU refresh rate change
│   ├── 03_displaylink_reload.ps1   # DisplayLink device reload
│   ├── Run-All.ps1                 # Combined wrapper script
│   └── README.md                   # Deployment instructions
├── deploy/                         # Generated deployment package
│   ├── Files/
│   │   └── DisplayUtilLive.dll     # Ready for deployment
│   ├── 01_registry.ps1
│   ├── 02_gpu_change.ps1
│   ├── 03_displaylink_reload.ps1
│   ├── Run-All.ps1
│   ├── README.md
│   └── MANIFEST.txt
├── DisplayUtilLive.cs              # C# source code
├── Build-DLL.ps1                   # PowerShell build script
├── Build.bat                       # Batch build script (alternative)
├── Deploy-Package.ps1              # Creates baramundi deployment package
├── Test-DLL.ps1                    # Test script
├── Hertz.ps1                       # Main script for setting refresh rates
├── DisplayUtilLive.csproj          # Visual Studio project
├── DisplayUtilLive.sln             # Visual Studio solution
└── README.md                       # This file

Deployment Location:

C:\Local\MonitorFix\deploy\MonitorFix\deploy\Files\
└── DisplayUtilLive.dll         # DLL for portable use (auto-copied during build)

---

API Documentation

SetAllMonitorsTo(int hz)

Sets all active monitors to the specified refresh rate.

[DisplayUtilLive]::SetAllMonitorsTo(60)  // Set to 60 Hz
[DisplayUtilLive]::SetAllMonitorsTo(144) // Set to 144 Hz

Parameters:

• hz: Frequency in Hertz (1-500)

Behavior:

• Validates mode support before changing
• Keeps resolution and color depth unchanged
• Throws exception if any monitor fails

Output:

=== SetAllMonitorsTo(60 Hz) ===
Successful changes: 2
✓ \\.\DISPLAY1 (Intel(R) UHD Graphics): 60 Hz → 60 Hz already at 60 Hz
✓ \\.\DISPLAY2 (DisplayLink USB Device): 75 Hz → 60 Hz successful

GetCurrentStatus()

Displays current configuration of all monitors.

[DisplayUtilLive]::GetCurrentStatus()

Output:

=== Current Monitor Configuration ===

\\.\DISPLAY1:
  Name: Intel(R) Iris(R) Xe Graphics
  ID: PCI\VEN_8086&DEV_9A49...
  Resolution: 1920x1080
  Frequency: 60 Hz
  Color depth: 32 bit

ListSupportedModes(string deviceName)

Lists all available modes for a specific monitor (debug).

[DisplayUtilLive]::ListSupportedModes("\\\\.\\DISPLAY1")

Output:

Available modes for \\.\DISPLAY1:
  - 1920x1080 @ 60 Hz (32 bit)
  - 1920x1080 @ 75 Hz (32 bit)
  - 1920x1080 @ 120 Hz (32 bit)

---

Portable Usage

No Installation Required

The DLL works on any Windows system without installing .NET Framework (it's built-in on Windows 10/11).

Recommended portable location:

# DLL is automatically deployed to C:\Local\MonitorFix\deploy\MonitorFix\deploy\Files during build
# Use Hertz.ps1 which loads from this location:
.\Hertz.ps1 60

Manual deployment:

# 1. Copy bin/DisplayUtilLive.dll to C:\Local\MonitorFix\deploy\MonitorFix\deploy\Files on target machine
# 2. Run from any location
Add-Type -Path "C:\Local\MonitorFix\deploy\MonitorFix\deploy\Files\DisplayUtilLive.dll"
[DisplayUtilLive]::SetAllMonitorsTo(60)

Portable Build System

Build without Visual Studio using Windows built-in csc.exe:

# Finds csc.exe automatically
.\Build-DLL.ps1

# Batch alternative
Build.bat

---

baramundi Integration

Ready-to-use deployment package available!

Quick Start for baramundi

1. Create deployment package:

.\Deploy-Package.ps1

This creates .\deploy\ with all files ready for baramundi deployment.

2. Upload to baramundi:

• Upload contents of .\deploy\ to baramundi server
• Configure File-Deploy: deploy\* → C:\Local\MonitorFix\deploy\

3. Create Execute Job:

# Option A: Single combined job
powershell.exe -ExecutionPolicy Bypass -File "C:\Local\MonitorFix\deploy\Run-All.ps1" -Hz 60

# Option B: Three separate jobs (recommended)
Job 1: powershell.exe -ExecutionPolicy Bypass -File "C:\Local\MonitorFix\deploy\01_registry.ps1" -Hz 60
Job 2: powershell.exe -ExecutionPolicy Bypass -File "C:\Local\MonitorFix\deploy\02_gpu_change.ps1" -Hz 60
Job 3: powershell.exe -ExecutionPolicy Bypass -File "C:\Local\MonitorFix\deploy\03_displaylink_reload.ps1" -Hz 60

All jobs: Run as System, Admin: Yes

Scripts Included

All scripts are in .\baramundi\ and work with fixed paths under C:\Local\MonitorFix\deploy\:

• 01_registry.ps1 - Sets DisplayLink registry values
• 02_gpu_change.ps1 - Changes refresh rates (main script)
• 03_displaylink_reload.ps1 - Reloads DisplayLink devices
• Run-All.ps1 - Runs all three scripts sequentially

Features

✅ Portable - Uses fixed path C:\Local\MonitorFix\deploy\MonitorFix\deploy\Files\DisplayUtilLive.dll ✅ No search logic - baramundi handles file deployment ✅ Clear exit codes - 0=Success, 1-3=Error codes for monitoring ✅ Universal - Works with Intel, NVIDIA, AMD, DisplayLink ✅ Tested - Ready for production deployment

Full Documentation

See .\baramundi\README.md for:

• Detailed baramundi configuration
• Exit codes and troubleshooting
• File deployment mapping
• Testing procedures

---

Testing

# Test 1: View current status (no admin required)
.\Test-DLL.ps1

# Test 2: Change frequency (requires admin)
.\Test-DLL.ps1 -TestFrequency 60

# Test 3: Verbose output
.\Test-DLL.ps1 -TestFrequency 144 -Verbose

---

Troubleshooting

DLL cannot be loaded

Error:

Add-Type: Could not load file or assembly...

Solution:

1. Check if DLL exists: Test-Path $dllPath
2. Unblock DLL: Unblock-File -Path $dllPath
3. Check .NET Framework 4.0+ is installed (built-in on Windows 10/11)

Access denied / No admin rights

Error:

ChangeDisplaySettingsEx failed

Solution:

• Run PowerShell as Administrator
• Or: Run from baramundi with System account

DisplayLink frequency stays unchanged

Cause: DisplayLink reads frequency from registry, not from DEVMODE

Solution:

1. Run Script 1 (Registry) FIRST
2. Run Script 2 (GPU Change)
3. Run Script 3 (Reload) LAST
4. Order matters: Registry → GPU → Reload

---

Technical Details

Windows API

Uses native Windows APIs:

• EnumDisplayDevices: Lists all display devices
• EnumDisplaySettings: Reads current/available modes
• ChangeDisplaySettingsEx: Changes display settings

DEVMODE Structure

dmFields = DM_DISPLAYFREQUENCY | DM_PELSWIDTH | DM_PELSHEIGHT | DM_BITSPERPEL
dmDisplayFrequency = 60  // New frequency
dmPelsWidth = 1920       // Preserved resolution
dmPelsHeight = 1080
dmBitsPerPel = 32

CDS_TEST Validation

Before applying changes:

ChangeDisplaySettingsEx(deviceName, ref devMode, IntPtr.Zero, CDS_TEST, IntPtr.Zero)

Only if DISP_CHANGE_SUCCESSFUL → apply with CDS_UPDATEREGISTRY.

DisplayLink Special Handling

DisplayLink stores frequency in registry:

HKLM\SYSTEM\CurrentControlSet\Enum\{PNPDeviceID}\Device Parameters\DisplayFrequency

Therefore:

1. Set registry value
2. Apply GPU change (sets DEVMODE)
3. PnP reload (loads new settings)

---

System Requirements

• Windows 10/11 (or Server 2016+)
• .NET Framework 4.0+ (built-in)
• PowerShell 5.1+ (built-in)
• Administrator rights (for changing refresh rates)

---

Build Requirements

Runtime (using pre-compiled DLL):

• None! Just copy bin/DisplayUtilLive.dll and use

Building from source:

• Windows built-in csc.exe (no VS required)
• OR Visual Studio 2019/2022 (any edition)

---

License

MIT License - Free to use and modify

---

Credits

Created by: catto Repository: https://github.com/caaatto/HzConfiguration Version: 1.0 Last Updated: 2025-01-27

---

Support

Issues: https://github.com/caaatto/HzConfiguration/issues

Common Commands:

# View all displays
Get-CimInstance Win32_VideoController | Select-Object Name, VideoProcessor, PNPDeviceID

# Find DisplayLink devices
Get-CimInstance Win32_VideoController | Where-Object { $_.Name -like '*DisplayLink*' }

# Check registry (DisplayLink)
Get-ItemProperty "HKLM:\SYSTEM\CurrentControlSet\Enum\{PNPDeviceID}\Device Parameters"

---

Examples

Example 1: Simple Usage

Add-Type -Path ".\bin\DisplayUtilLive.dll"
[DisplayUtilLive]::SetAllMonitorsTo(60)

Example 2: Error Handling

param([int]$Hz = 60)

try {
    Add-Type -Path ".\bin\DisplayUtilLive.dll" -ErrorAction Stop
    [DisplayUtilLive]::SetAllMonitorsTo($Hz)
    Write-Host "Success: All monitors set to $Hz Hz" -ForegroundColor Green
    exit 0
} catch {
    Write-Error "Error: $($_.Exception.Message)"
    exit 1
}

Example 3: Check Before Change

Add-Type -Path ".\bin\DisplayUtilLive.dll"

# Show current
Write-Host "Current configuration:" -ForegroundColor Cyan
[DisplayUtilLive]::GetCurrentStatus()

# Change
Write-Host "`nChanging to 60 Hz..." -ForegroundColor Cyan
[DisplayUtilLive]::SetAllMonitorsTo(60)

# Verify
Write-Host "`nNew configuration:" -ForegroundColor Cyan
[DisplayUtilLive]::GetCurrentStatus()

---

Enjoy your perfectly configured monitors! 🖥️