AMDHotkeys.psm1
|
Set-StrictMode -Version Latest # Guard: Only support Windows platforms (works in both Windows PowerShell and PowerShell 7+) $__isWindows = $false try { $__isWindows = [System.Environment]::OSVersion.Platform -eq [System.PlatformID]::Win32NT } catch { $__isWindows = $false } if (-not $__isWindows) { throw 'AMDHotkeys supports Windows only. Import on non-Windows is not supported.' } Set-Variable -Option Constant -Name AMDLocalMachineRootPath -Value "HKLM:\Software\AMD\DVR" Set-Variable -Option Constant -Name AMDCurrentUserRootPath -Value "HKCU:\Software\AMD\DVR" Set-Variable -Option Constant -Name HotkeysDisabledPath -Value "$AMDCurrentUserRootPath\HotkeysDisabled" Set-Variable -Option Constant -Name Hotkeys -Value ([Ordered]@{ "$AMDLocalMachineRootPath\ToggleRsHotkey" = "Alt,R" "$AMDLocalMachineRootPath\ToggleRsPerfUiHotkey" = "Ctrl+Shift,O" "$AMDLocalMachineRootPath\ToggleRsPerfRecordingHotkey" = "Ctrl+Shift,L" "$AMDLocalMachineRootPath\Rotation00Hotkey" = "Ctrl+Alt,VK_UP" "$AMDLocalMachineRootPath\Rotation90Hotkey" = "Ctrl+Alt,VK_LEFT" "$AMDLocalMachineRootPath\Rotation180Hotkey" = "Ctrl+Alt,VK_DOWN" "$AMDLocalMachineRootPath\Rotation270Hotkey" = "Ctrl+Alt,VK_RIGHT" "$AMDLocalMachineRootPath\ToggleDvrToolbarHotkey" = "Alt,Z" "$AMDLocalMachineRootPath\ToggleDvrRecordingHotkey" = "Ctrl+Shift,E" "$AMDLocalMachineRootPath\ToggleStreamingHotkey" = "Ctrl+Shift,G" "$AMDLocalMachineRootPath\ToggleCameraHotkey" = "Ctrl+Shift,C" "$AMDLocalMachineRootPath\ToggleMicrophoneHotkey" = "Ctrl+Shift,M" "$AMDLocalMachineRootPath\TakeScreenshotHotkey" = "Ctrl+Shift,I" "$AMDLocalMachineRootPath\SaveInstantReplayHotkey" = "Ctrl+Shift,S" "$AMDLocalMachineRootPath\SaveInstantGifHotkey" = "Ctrl+Shift,J" "$AMDLocalMachineRootPath\SaveInGameReplayHotkey" = "Ctrl+Shift,U" "$AMDLocalMachineRootPath\ToggleUpscaling" = "Alt,U" }) <# .SYNOPSIS Checks if AMD Radeon Software is installed on the system. .DESCRIPTION Tests for the existence of required AMD registry paths to determine if AMD Radeon Software is installed. .EXAMPLE Test-AMDSoftwareInstalled Returns $true if AMD Radeon Software is installed, $false otherwise. #> function Test-AMDSoftwareInstalled { # Use CmdletBinding to allow for common parameters (e.g. -Verbose) [CmdletBinding()] param() if (-not ((Test-Path $AMDLocalMachineRootPath) -and (Test-Path $AMDCurrentUserRootPath))) { Write-Verbose "Registry path $AMDLocalMachineRootPath or $AMDCurrentUserRootPath does not exist." Write-Warning "AMD Radeon Software is not installed." return $false } Write-Verbose "AMD Radeon Software is installed." return $true } <# .SYNOPSIS Checks if AMD Radeon Software hotkeys are currently enabled. .DESCRIPTION Tests the Windows registry to determine if AMD Radeon Software hotkeys are enabled. .EXAMPLE Test-AMDHotkeysEnabled Returns $true if AMD Radeon Software hotkeys are enabled, $false otherwise. #> function Test-AMDHotkeysEnabled { # Use CmdletBinding to allow for common parameters (e.g. -Verbose) [CmdletBinding()] param() $hotkeysDisabled = $null if (Test-AMDSoftwareInstalled) { try { $hotkeysDisabled = Get-ItemPropertyValue ` -Path (Split-Path $HotkeysDisabledPath -Parent) ` -Name (Split-Path $HotkeysDisabledPath -Leaf) Write-Verbose "$HotkeysDisabledPath registry value: $hotkeysDisabled" } catch { Write-Verbose $_.Exception.Message } } return $(if ($hotkeysDisabled -eq 0) {$true} else {$false}) } <# .SYNOPSIS Disables AMD Radeon Software hotkeys. .DESCRIPTION Disables hotkey functionality. .EXAMPLE Disable-AMDHotkeys Disables hotkey functionality. #> function Disable-AMDHotkeys { # Use CmdletBinding to allow for common parameters (e.g. -Verbose) [CmdletBinding()] param() if (Test-AMDSoftwareInstalled) { Set-ItemProperty ` -Path (Split-Path $HotkeysDisabledPath -Parent) ` -Name (Split-Path $HotkeysDisabledPath -Leaf) ` -Value 1 Restart-AMDSettingsService } } <# .SYNOPSIS Enables AMD Radeon Software hotkeys. .DESCRIPTION Enables hotkey functionality. .EXAMPLE Enable-AMDHotkeys Enables hotkey functionality. #> function Enable-AMDHotkeys { # Use CmdletBinding to allow for common parameters (e.g. -Verbose) [CmdletBinding()] param() if (Test-AMDSoftwareInstalled) { Set-ItemProperty ` -Path (Split-Path $HotkeysDisabledPath -Parent) ` -Name (Split-Path $HotkeysDisabledPath -Leaf) ` -Value 0 Restart-AMDSettingsService } } <# .SYNOPSIS Gets all AMD Radeon Software hotkey bindings. .DESCRIPTION Gets all hotkey assignments. .EXAMPLE Get-AMDHotkeys Gets all hotkey assignments. #> function Get-AMDHotkeys { # Use CmdletBinding to allow for common parameters (e.g. -Verbose) [CmdletBinding()] param() if (Test-AMDSoftwareInstalled) { $hotkeyList = foreach ($path in $Hotkeys.Keys) { $value = Get-ItemPropertyValue ` -Path (Split-Path $path -Parent) ` -Name (Split-Path $path -Leaf) [PSCustomObject][Ordered]@{ RegistryPath = $path Hotkey = $value } } return $hotkeyList } } <# .SYNOPSIS Clears all AMD Radeon Software hotkey bindings. .DESCRIPTION Clears all hotkey assignments. .EXAMPLE Clear-AMDHotkeys Clears all hotkey assignments. #> function Clear-AMDHotkeys { # Use CmdletBinding to allow for common parameters (e.g. -Verbose) [CmdletBinding()] param() if (Test-AMDSoftwareInstalled) { foreach ($path in $Hotkeys.Keys) { Set-ItemProperty ` -Path (Split-Path $path -Parent) ` -Name (Split-Path $path -Leaf) ` -Value "" } Restart-AMDSettingsService } } <# .SYNOPSIS Restores default AMD Radeon Software hotkey bindings. .DESCRIPTION Restores all hotkey assignments to their default value. .EXAMPLE Restore-AMDHotkeys Restores all hotkey assignments to their default value. #> function Restore-AMDHotkeys { # Use CmdletBinding to allow for common parameters (e.g. -Verbose) [CmdletBinding()] param() if (Test-AMDSoftwareInstalled) { foreach ($path in $Hotkeys.Keys) { Set-ItemProperty ` -Path (Split-Path $path -Parent) ` -Name (Split-Path $path -Leaf) ` -Value $Hotkeys[$path] } Restart-AMDSettingsService } } <# .SYNOPSIS Restarts the AMD Radeon Settings Service. .DESCRIPTION Restarts the AMD Radeon Settings Service by terminating the AMDRSServ process, which will automatically restart. .NOTES The AMD Radeon Settings Service is not a standard Windows service and must be restarted by terminating its process. .EXAMPLE Restart-AMDSettingsService Restarts the AMD Radeon Settings Service. #> function Restart-AMDSettingsService { # Use CmdletBinding to allow for common parameters (e.g. -Verbose) [CmdletBinding()] param() # AMDRSServ is the AMD Radeon Settings Service. It is not an actual Windows service and so # cannot be restarted with Restart-Service. However, it will automatically restart if we kill # the process. Get-Process -Name "AMDRSServ" -ErrorAction SilentlyContinue | Stop-Process -Force } Export-ModuleMember ` -Function ` Test-AMDHotkeysEnabled, ` Disable-AMDHotkeys, ` Enable-AMDHotkeys, ` Get-AMDHotkeys, ` Clear-AMDHotkeys, ` Restore-AMDHotkeys |