Fixlet | Set Display Resolution to Maximum Resolution

Set Display Resolution to Maximum Resolution
Log In or Register to download the BES file, and more.

0 Votes

Versioning - This is the latest version.

1	Set Display Resolution to Maximum Resolution	7/20/2026 1:21:19 PM
2	Set Display Resolution to Maximum Resolution	7/21/2026 6:25:33 AM
3	Set Display Resolution to Maximum Resolution	7/21/2026 6:28:06 AM
4	Set Display Resolution to Maximum Resolution	7/28/2026 10:34:40 AM

Description

Sets the resolution of a computer to its recommended max resolution. Works best with laptops, may have issues with computers connected to multiple displays of different resolutions.

Works utilizing one of two methods:

If user logged on and not on lock screen: Utilizes DisplaySettings PowerShell module (embedded in actionscript) which uses the ChangeDisplaySettings function to change the display settings.
If no user logged on or on lock screen: Utilizes direct registry edits and then restarts the display driver.

WARNING: Restarting the display driver will cause the screen to temporarily go black.
WARNING: This will modify ALL display configurations for the device and may have unintended consequences.

Property Details

ID	27420
Status	Beta - Preliminary testing ready for more
Title	Set Display Resolution to Maximum Resolution
Domain	BESC
Source	Internal
Source Release Date	7/14/2026 12:00:00 AM
Keywords	display, screen, resolution
Is Task	True
Added by	skyler on 7/28/2026 10:34:40 AM
Last Modified by	skyler on 7/28/2026 10:34:40 AM
Counters	392 Views / 0 Downloads
User Rating	* Average over 0 ratings. ** Log In or Register to add your rating.

Relevance

Relevance 3020200

Used in 4 fixlets and 3 analyses

* Results in a true/false

(name of it starts with "Win") of operating system

Actions

Action 1 (default)

Action Link Click here to use ChangeDisplaySettings or registry edit method depending if a user is logged on.

Script Type BigFix Action Script

// Create PowerShell script
parameter "ScriptPath" = "__Download\display-resolution.ps1"
delete "{(parameter "ScriptPath")}"

if {(exists process "logonui.exe") or (not exists logged on users whose (active of it = True))}
    createfile until ENDOFSCRIPT
    
    $resolution = Get-WmiObject -Class CIM_VideoControllerResolution | Sort-Object -Property @{{Expression={{$_.HorizontalResolution * $_.VerticalResolution}} -Descending | Select-Object -First 1 -Property HorizontalResolution, VerticalResolution
    
    $displayConfigs = Get-Item HKLM:\SYSTEM\CurrentControlSet\Control\GraphicsDrivers\Configuration\*\00
    $displayConfigs | ForEach-Object {{
        Set-ItemProperty -Path $_.PsPath -Name PrimSurfSize.cx -Value $resolution.HorizontalResolution -Force
        Set-ItemProperty -Path $_.PsPath -Name PrimSurfSize.cy -Value $resolution.VerticalResolution -Force
        Set-ItemProperty -Path "$($_.PsPath)\00" -Name ActiveSize.cx -Value $resolution.HorizontalResolution -Force
        Set-ItemProperty -Path "$($_.PsPath)\00" -Name ActiveSize.cy -Value $resolution.VerticalResolution -Force
        Set-ItemProperty -Path "$($_.PsPath)\00" -Name DwmClipBox.bottom -Value $resolution.VerticalResolution -Force
        Set-ItemProperty -Path "$($_.PsPath)\00" -Name DwmClipBox.left -Value 0 -Force
        Set-ItemProperty -Path "$($_.PsPath)\00" -Name DwmClipBox.right -Value $resolution.HorizontalResolution -Force
        Set-ItemProperty -Path "$($_.PsPath)\00" -Name DwmClipBox.top -Value 0 -Force
        Set-ItemProperty -Path "$($_.PsPath)\00" -Name PrimSurfSize.cx -Value $resolution.HorizontalResolution -Force
        Set-ItemProperty -Path "$($_.PsPath)\00" -Name PrimSurfSize.cy -Value $resolution.VerticalResolution -Force
    }

    $displayDriver = Get-PnpDevice | Where-Object {{ $_.Class -like "Display*" }
    $displayDriver | Disable-PnpDevice -Confirm:$false
    $displayDriver | Enable-PnpDevice -Confirm:$false

    ENDOFSCRIPT
else
    createfile until ENDOFSCRIPT

    $cds = @"
    namespace cds
    {{
        using System;
        using System.Runtime.InteropServices;

        [StructLayout(LayoutKind.Explicit)]
        public struct DEVMODE
        {{
            [FieldOffset(102)]
            public short dmLogPixels;
            [FieldOffset(104)]
            public int dmBitsPerPel;
            [FieldOffset(108)]
            public int dmPelsWidth;
            [FieldOffset(112)]
            public int dmPelsHeight;
            [FieldOffset(116)]
            public int dmDisplayFlags;
            [FieldOffset(120)]
            public int dmDisplayFrequency;
        }


        // https://docs.microsoft.com/en-us/windows/win32/api/winuser/nf-winuser-changedisplaysettingsa
        public class Helper
        {{
            public static DEVMODE GetDisplaySettings()
            {{
                // #define ENUM_CURRENT_SETTINGS       ((DWORD)-1)
                // #define ENUM_REGISTRY_SETTINGS      ((DWORD)-2)
                var devMode = new DEVMODE();

                // A NULL value specifies the current display device on the computer on which the calling thread is running.
                var retCode = EnumDisplaySettings(null, -1, ref devMode);
                if (retCode == 0)
                {{
                    throw new Exception("can't get resolution from win api");
                }

                return devMode;
            }

            public static string ChangeDisplaySettings(int width, int height, int flags)
            {{
                // /* Return values for ChangeDisplaySettings */
                // #define DISP_CHANGE_SUCCESSFUL       0
                // #define DISP_CHANGE_RESTART          1
                // #define DISP_CHANGE_FAILED          -1
                // #define DISP_CHANGE_BADMODE         -2
                // #define DISP_CHANGE_NOTUPDATED      -3
                // #define DISP_CHANGE_BADFLAGS        -4
                // #define DISP_CHANGE_BADPARAM        -5
                // #if(_WIN32_WINNT >= 0x0501)
                // #define DISP_CHANGE_BADDUALVIEW     -6
                // #endif /* _WIN32_WINNT >= 0x0501 */

                var devMode = GetDisplaySettings();

                devMode.dmPelsWidth = width;
                devMode.dmPelsHeight = height;

                var res = ChangeDisplaySettings(ref devMode, flags);
                switch (res)
                {{
                    case 0:
                        return "The settings change was successful.";
                    case 1:
                        return "The computer must be restarted for the graphics mode to work.";
                    case -1:
                        return "The display driver failed the specified graphics mode.";
                    case -2:
                        return "The graphics mode is not supported.";
                    case -3:
                        return "Unable to write settings to the registry.";
                    case -4:
                        return "An invalid set of flags was passed in.";
                    case -5:
                        return "An invalid parameter was passed in. This can include an invalid flag or combination of flags.";
                    case -6:
                        return "The settings change was unsuccessful because the system is DualView capable.";
                    default:
                        return "unknow return code: " + res;
                }
            }

            [DllImport("user32.dll")]
            static extern int EnumDisplaySettings(string deviceName, int modeNum, ref DEVMODE devMode);

            [DllImport("user32.dll")]
            public static extern int ChangeDisplaySettings(ref DEVMODE devMode, int flags);

            public class Flags
            {{
                // #define CDS_UPDATEREGISTRY           0x00000001
                // #define CDS_TEST                     0x00000002
                // #define CDS_FULLSCREEN               0x00000004
                // #define CDS_GLOBAL                   0x00000008
                // #define CDS_SET_PRIMARY              0x00000010
                // #define CDS_RESET                    0x40000000
                // #define CDS_NORESET                  0x10000000

                public const int CDS_UPDATEREGISTRY = 0x01;
                public const int CDS_TEST = 0x02;
                public const int CDS_FULLSCREEN = 0x04;
                public const int CDS_GLOBAL = 0x08;
                public const int CDS_SET_PRIMARY = 0x10;
                public const int CDS_RESET = 0x40000000;
                public const int CDS_NORESET = 0x10000000;
            }
        }
    }
    "@

    [Flags()] enum CDSFlags {{
        Dynamically = 0
        UpdateRegistry = 0x01
        Test = 0x02
        FullScreen = 0x04
        Global = 0x08
        SetPrimary = 0x10
        Reset = 0x40000000
        NoReset = 0x10000000
    }

    Add-Type -TypeDefinition $cds

    function Set-DisplayResolution {{
        param (
            [Parameter(Mandatory = $true, Position = 0)] 
            [int]$Width, 

            [Parameter(Mandatory = $true, Position = 1)] 
            [int]$Height,

            [CDSFlags]
            $Flag = [CDSFlags]::Dynamically
        )
        
        [cds.Helper]::ChangeDisplaySettings($Width, $Height, $Flag)
    }

    function Get-DisplayResolution {{
        [cds.Helper]::GetDisplaySettings()
    }

    $resolution = Get-WmiObject -Class CIM_VideoControllerResolution | Sort-Object -Property @{{Expression={{$_.HorizontalResolution * $_.VerticalResolution}} -Descending | Select-Object -First 1 -Property HorizontalResolution, VerticalResolution

    Set-DisplayResolution -Width $resolution.HorizontalResolution -Height $resolution.VerticalResolution -Flag "Global, UpdateRegistry"

    ENDOFSCRIPT
endif

// Run script
copy __createfile "{(parameter "ScriptPath")}"

if {(exists process "logonui.exe") or (not exists logged on users whose (active of it = True))}
    waithidden powershell.exe -ExecutionPolicy Bypass -WindowStyle Hidden -File "{(parameter "ScriptPath")}"
else
    override wait // SYSTEM user is unable to change display settings w/ ChangeDisplaySettings function, must run as current user
        completion=job
        hidden=true
        runas=currentuser
    wait powershell.exe -ExecutionPolicy Bypass -WindowStyle Hidden -File "{(parameter "ScriptPath")}"
endif

//delete "{(parameter "ScriptPath")}"

Success Criteria

This action will be considered successful when the applicability relevance evaluates to false.

Action 2

Action Link Click here to only use ChangeDisplaySettings method. Requires user to be logged on.

Script Type BigFix Action Script

continue if {(not exists process "logonui.exe") and (exists logged on users whose (active of it = True))}

// Create PowerShell script
parameter "ScriptPath" = "__Download\display-resolution.ps1"
delete "{(parameter "ScriptPath")}"

createfile until ENDOFSCRIPT

$cds = @"
namespace cds
{{
    using System;
    using System.Runtime.InteropServices;

    [StructLayout(LayoutKind.Explicit)]
    public struct DEVMODE
    {{
        [FieldOffset(102)]
        public short dmLogPixels;
        [FieldOffset(104)]
        public int dmBitsPerPel;
        [FieldOffset(108)]
        public int dmPelsWidth;
        [FieldOffset(112)]
        public int dmPelsHeight;
        [FieldOffset(116)]
        public int dmDisplayFlags;
        [FieldOffset(120)]
        public int dmDisplayFrequency;
    }


    // https://docs.microsoft.com/en-us/windows/win32/api/winuser/nf-winuser-changedisplaysettingsa
    public class Helper
    {{
        public static DEVMODE GetDisplaySettings()
        {{
            // #define ENUM_CURRENT_SETTINGS       ((DWORD)-1)
            // #define ENUM_REGISTRY_SETTINGS      ((DWORD)-2)
            var devMode = new DEVMODE();

            // A NULL value specifies the current display device on the computer on which the calling thread is running.
            var retCode = EnumDisplaySettings(null, -1, ref devMode);
            if (retCode == 0)
            {{
                throw new Exception("can't get resolution from win api");
            }

            return devMode;
        }

        public static string ChangeDisplaySettings(int width, int height, int flags)
        {{
            // /* Return values for ChangeDisplaySettings */
            // #define DISP_CHANGE_SUCCESSFUL       0
            // #define DISP_CHANGE_RESTART          1
            // #define DISP_CHANGE_FAILED          -1
            // #define DISP_CHANGE_BADMODE         -2
            // #define DISP_CHANGE_NOTUPDATED      -3
            // #define DISP_CHANGE_BADFLAGS        -4
            // #define DISP_CHANGE_BADPARAM        -5
            // #if(_WIN32_WINNT >= 0x0501)
            // #define DISP_CHANGE_BADDUALVIEW     -6
            // #endif /* _WIN32_WINNT >= 0x0501 */

            var devMode = GetDisplaySettings();

            devMode.dmPelsWidth = width;
            devMode.dmPelsHeight = height;

            var res = ChangeDisplaySettings(ref devMode, flags);
            switch (res)
            {{
                case 0:
                    return "The settings change was successful.";
                case 1:
                    return "The computer must be restarted for the graphics mode to work.";
                case -1:
                    return "The display driver failed the specified graphics mode.";
                case -2:
                    return "The graphics mode is not supported.";
                case -3:
                    return "Unable to write settings to the registry.";
                case -4:
                    return "An invalid set of flags was passed in.";
                case -5:
                    return "An invalid parameter was passed in. This can include an invalid flag or combination of flags.";
                case -6:
                    return "The settings change was unsuccessful because the system is DualView capable.";
                default:
                    return "unknow return code: " + res;
            }
        }

        [DllImport("user32.dll")]
        static extern int EnumDisplaySettings(string deviceName, int modeNum, ref DEVMODE devMode);

        [DllImport("user32.dll")]
        public static extern int ChangeDisplaySettings(ref DEVMODE devMode, int flags);

        public class Flags
        {{
            // #define CDS_UPDATEREGISTRY           0x00000001
            // #define CDS_TEST                     0x00000002
            // #define CDS_FULLSCREEN               0x00000004
            // #define CDS_GLOBAL                   0x00000008
            // #define CDS_SET_PRIMARY              0x00000010
            // #define CDS_RESET                    0x40000000
            // #define CDS_NORESET                  0x10000000

            public const int CDS_UPDATEREGISTRY = 0x01;
            public const int CDS_TEST = 0x02;
            public const int CDS_FULLSCREEN = 0x04;
            public const int CDS_GLOBAL = 0x08;
            public const int CDS_SET_PRIMARY = 0x10;
            public const int CDS_RESET = 0x40000000;
            public const int CDS_NORESET = 0x10000000;
        }
    }
}
"@

[Flags()] enum CDSFlags {{
    Dynamically = 0
    UpdateRegistry = 0x01
    Test = 0x02
    FullScreen = 0x04
    Global = 0x08
    SetPrimary = 0x10
    Reset = 0x40000000
    NoReset = 0x10000000
}

Add-Type -TypeDefinition $cds

function Set-DisplayResolution {{
    param (
        [Parameter(Mandatory = $true, Position = 0)] 
        [int]$Width, 

        [Parameter(Mandatory = $true, Position = 1)] 
        [int]$Height,

        [CDSFlags]
        $Flag = [CDSFlags]::Dynamically
    )
    
    [cds.Helper]::ChangeDisplaySettings($Width, $Height, $Flag)
}

function Get-DisplayResolution {{
    [cds.Helper]::GetDisplaySettings()
}

$resolution = Get-WmiObject -Class CIM_VideoControllerResolution | Sort-Object -Property @{{Expression={{$_.HorizontalResolution * $_.VerticalResolution}} -Descending | Select-Object -First 1 -Property HorizontalResolution, VerticalResolution

Set-DisplayResolution -Width $resolution.HorizontalResolution -Height $resolution.VerticalResolution -Flag "Global, UpdateRegistry"

ENDOFSCRIPT

// Run script
copy __createfile "{(parameter "ScriptPath")}"

override wait // SYSTEM user is unable to change display settings w/ ChangeDisplaySettings function, must run as current user
    completion=job
    hidden=true
    runas=currentuser
wait powershell.exe -ExecutionPolicy Bypass -WindowStyle Hidden -File "{(parameter "ScriptPath")}"

//delete "{(parameter "ScriptPath")}"

Success Criteria

This action will be considered successful when the applicability relevance evaluates to false.

Action 3

Action Link Click here to only use registry edit method.

Script Type BigFix Action Script

// Create PowerShell script
parameter "ScriptPath" = "__Download\display-resolution.ps1"
delete "{(parameter "ScriptPath")}"

createfile until ENDOFSCRIPT

$resolution = Get-WmiObject -Class CIM_VideoControllerResolution | Sort-Object -Property @{{Expression={{$_.HorizontalResolution * $_.VerticalResolution}} -Descending | Select-Object -First 1 -Property HorizontalResolution, VerticalResolution

$displayConfigs = Get-Item HKLM:\SYSTEM\CurrentControlSet\Control\GraphicsDrivers\Configuration\*\00
$displayConfigs | ForEach-Object {{
    Set-ItemProperty -Path $_.PsPath -Name PrimSurfSize.cx -Value $resolution.HorizontalResolution -Force
    Set-ItemProperty -Path $_.PsPath -Name PrimSurfSize.cy -Value $resolution.VerticalResolution -Force
    Set-ItemProperty -Path "$($_.PsPath)\00" -Name ActiveSize.cx -Value $resolution.HorizontalResolution -Force
    Set-ItemProperty -Path "$($_.PsPath)\00" -Name ActiveSize.cy -Value $resolution.VerticalResolution -Force
    Set-ItemProperty -Path "$($_.PsPath)\00" -Name DwmClipBox.bottom -Value $resolution.VerticalResolution -Force
    Set-ItemProperty -Path "$($_.PsPath)\00" -Name DwmClipBox.left -Value 0 -Force
    Set-ItemProperty -Path "$($_.PsPath)\00" -Name DwmClipBox.right -Value $resolution.HorizontalResolution -Force
    Set-ItemProperty -Path "$($_.PsPath)\00" -Name DwmClipBox.top -Value 0 -Force
    Set-ItemProperty -Path "$($_.PsPath)\00" -Name PrimSurfSize.cx -Value $resolution.HorizontalResolution -Force
    Set-ItemProperty -Path "$($_.PsPath)\00" -Name PrimSurfSize.cy -Value $resolution.VerticalResolution -Force
}

$displayDriver = Get-PnpDevice | Where-Object {{ $_.Class -like "Display*" }
$displayDriver | Disable-PnpDevice -Confirm:$false
$displayDriver | Enable-PnpDevice -Confirm:$false

ENDOFSCRIPT

// Run script
copy __createfile "{(parameter "ScriptPath")}"

waithidden powershell.exe -ExecutionPolicy Bypass -WindowStyle Hidden -File "{(parameter "ScriptPath")}"

//delete "{(parameter "ScriptPath")}"

Success Criteria

This action will be considered successful when the applicability relevance evaluates to false.

Action 4

Action Link Click here to view DisplaySettings PowerShell module from PowerShell Gallery.

Script Type URL

https://www.powershellgallery.com/packages/DisplaySettings/0.0.2

Action 5

Action Link Click here to view ChangeDisplaySettings function documentation from Microsoft.

Script Type URL

https://learn.microsoft.com/en-us/windows/win32/api/winuser/nf-winuser-changedisplaysettingsa

Sharing

Social Media:

Search for:	Relevance	Fixlets/Tasks
	Analyses	BFI Signatures
	Dashboard/Wizard

Title	Keywords	Description
Relevance	Domain	ActionScript
Mime	Signature Content	(clear all)


Content Search Share Learn Projects	Utilities View SCM Scripts Base64 Converter Shell to Action Script	About About Us Tour FAQ Terms Contact Us	BigFix Resources Download BigFix Support Forum Github/Bigfix

Set Display Resolution to Maximum Resolution Log In or Register to download the BES file, and more.

Versioning - This is the latest version.

Description

Property Details

Relevance

Actions

Action 1 (default)

Action 2

Action 3

Action 4

Action 5

Sharing

Comments

Content

Utilities

About

BigFix Resources

Set Display Resolution to Maximum Resolution
Log In or Register to download the BES file, and more.