Here is my learning from the RnD I did on system settings app (immersive control panel). (see my other answer for a simple C++ API I created from this learning - https://mcmap.net/q/440875/-how-can-i-change-windows-10-display-scaling-programmatically-using-c. A simpler method for single monitor setups, or if you want to change DPI of just the prmary monitor is given here - https://mcmap.net/q/440875/-how-can-i-change-windows-10-display-scaling-programmatically-using-c)
- System Settings app (new immersive control panel that comes with Windows 10) is able to do it. This means Certainly there is an API, only that Microsoft has not made it public.
- The Systems settings app is a UWP app, but can be hooked with a debugger - WinDbg.
I used WinDbg to go through calls made by this app. I found that as soon as a particular function is executed - user32!_imp_NtUserDisplayConfigSetDeviceInfo
the new DPI setting takes effect on my machine.
I wasn't able to set a break-point on this function, but was able to set one on DisplayConfigSetDeviceInfo()
(bp user32!DisplayConfigSetDeviceInfo)
.
DisplayConfigSetDeviceInfo (msdn link) is a public function, but it seems that the settings app is sending it parameters which are not documented.
Here are the parameters I found during my debugging session.
((user32!DISPLAYCONFIG_DEVICE_INFO_HEADER *)0x55df8fba30) : 0x55df8fba30 [Type: DISPLAYCONFIG_DEVICE_INFO_HEADER *]
[+0x000] type : -4 [Type: DISPLAYCONFIG_DEVICE_INFO_TYPE]
[+0x004] size : 0x18 [Type: unsigned int]
[+0x008] adapterId [Type: _LUID]
[+0x010] id : 0x0 [Type: unsigned int]
0:003> dx -r1 (*((user32!_LUID *)0x55df8fba38))
(*((user32!_LUID *)0x55df8fba38)) [Type: _LUID]
[+0x000] LowPart : 0xcbae [Type: unsigned long]
[+0x004] HighPart : 0 [Type: long]
Basically the values of the members of DISPLAYCONFIG_DEVICE_INFO_HEADER
struct which gets passed to DisplayConfigSetDeviceInfo()
are:
type : -4
size : 0x18
adapterId : LowPart : 0xcbae HighPart :0
The enum type, as defined in wingdi.h is :
typedef enum
{
DISPLAYCONFIG_DEVICE_INFO_GET_SOURCE_NAME = 1,
DISPLAYCONFIG_DEVICE_INFO_GET_TARGET_NAME = 2,
DISPLAYCONFIG_DEVICE_INFO_GET_TARGET_PREFERRED_MODE = 3,
DISPLAYCONFIG_DEVICE_INFO_GET_ADAPTER_NAME = 4,
DISPLAYCONFIG_DEVICE_INFO_SET_TARGET_PERSISTENCE = 5,
DISPLAYCONFIG_DEVICE_INFO_GET_TARGET_BASE_TYPE = 6,
DISPLAYCONFIG_DEVICE_INFO_GET_SUPPORT_VIRTUAL_RESOLUTION = 7,
DISPLAYCONFIG_DEVICE_INFO_SET_SUPPORT_VIRTUAL_RESOLUTION = 8,
DISPLAYCONFIG_DEVICE_INFO_GET_ADVANCED_COLOR_INFO = 9,
DISPLAYCONFIG_DEVICE_INFO_SET_ADVANCED_COLOR_STATE = 10,
DISPLAYCONFIG_DEVICE_INFO_FORCE_UINT32 = 0xFFFFFFFF
} DISPLAYCONFIG_DEVICE_INFO_TYPE;
While the settings app is trying to send -4 for type, we can see that the enum has no negative value.
If we are able to reverse engineer this fully, we will have a working API to set DPI of a monitor.
It seems incredibly unfair that Microsoft has some special API for its own apps, which others cannot use.
UPDATE 1 :
To verify my theory, I copied (using WinDbg), the bytes of the DISPLAYCONFIG_DEVICE_INFO_HEADER
struct which are sent to DisplayConfigSetDeviceInfo()
as parameter; when DPI scaling is changed from System Settings app (tried setting 150% DPI scaling).
I then wrote a simple C program to send these bytes (24 bytes - 0x18 bytes) to DisplayConfigSetDeviceInfo()
.
I then changed my DPI scaling back to 100%, and ran my code. Sure enough, the DPI scaling did change on running the code!!!
BYTE buf[] = { 0xFC,0xFF,0xFF,0xFF,0x18,0x00,0x00,0x00,0xAE,0xCB,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x01,0x00,0x00,0x00 };
DISPLAYCONFIG_DEVICE_INFO_HEADER* packet = (DISPLAYCONFIG_DEVICE_INFO_HEADER*)buf;
DisplayConfigSetDeviceInfo(packet);
Note that the same code may not work for you as the LUID, and id parameters, which points to a display on a system would be different (LUID generally is used for GPU, id could be source ID, target ID, or some other ID, this parameter depends on DISPLAYCONFIG_DEVICE_INFO_HEADER::type).
I now have to figure out the meaning of these 24 bytes.
UPDATE 2:
Here are the bytes I got when trying to set 175% dpi scaling.
BYTE buf[] = { 0xFC,0xFF,0xFF,0xFF,0x18,0x00,0x00,0x00,0xAE,0xCB,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x02,0x00,0x00,0x00 };
If we compare the two byte buffers, we can draw the following conclusions.
- Byte number 21 is being used to specify DPI scaling, as all other bytes are same between 150%, and 175%.
- For 150% scaling, the value of Byte 21 is 1, while for 175% it is 2. The default (recommended) DPI scaling for this monitor is 125%.
- From the technet article mentioned by @Dodge, in Windows parlance, 0 corresponds to recommended DPI scaling value. Other integers correspond to relative dpi scaling with respect to this recommended value. 1 means one step ahead in scaling, -1 means one step down. eg. if recommended is 125%, a value of 1 would mean 150% scaling. This is indeed what we saw.
The only thing remaining is now to figure out how to get recommended DPI scaling value for a display, we will then be able to write an API of the following form - SetDPIScaling(monitor_LUID, DPIScale_percent)
.
UPDATE 3:
If we check the registry entries mentioned in @Dodge's answer, we come to know that these integers are stored as DWORD, and since my computer is little endian it implies that the last 4 bytes (bytes 21 to 24) are being used for them.Thus to send negative numbers we will have to use 2's complement of the DWORD, and write the bytes as little endian.
UPDATE 4:
I have also been researching on how Windows tries to generate Monitor Ids for storing DPI scaling values.
For any monitor, the DPI scaling value selected by a user is stored at :
HKEY_CURRENT_USER\Control Panel\Desktop\PerMonitorSettings\
*MonitorID*
For a Dell display connected to my machine, the monitor ID was DELA0BC9DRXV68A0LWL_21_07E0_33^7457214C9330EFC0300669BF736A5297
.
I was able to figure out the structure of monitor ID. I verified my theory with 4 different monitors.
For the Dell display (dpi scaling stored at HKEY_CURRENT_USER\Control Panel\Desktop\PerMonitorSettings\ DELA0BC9DRXV68A0LWL_21_07E0_33^7457214C9330EFC0300669BF736A5297
), it is as follows (Sorry for adding image, couldn't figure out a way to represent the information as succinctly).
Essentially, the data required from EDID to construct monitor ID is as follows.
- Manufacturer ID
- Bytes 8, 9 of EDID (big endian).
- Eg. for the Dell display, the EDID has 10AC for these bytes. Except bit 15, use rest of the 15 bits (bits 0 to 14), 5 at a time. (10AC)16 equals (0001-0000-1010-1100)2. Breaking this binary into chunks of 5 bits, starting from LSB gives us (0-00100-00101-01100)2. Converting each chunk to decimal, (0-4-5-12)10, now 'D' is 4th alphabet, 'E' is 5th, and 'L' is 12th.
- Fallback :
@@@
- Product ID
- Bytes 10, 11 of EDID (little endian)
- Eg. for the Dell display, the EDID has BCA0. Since this is little endian, simply converting it to A0BC gives us product ID.
- Fallback :
000
- Serial number
- DTD serial number is used. Base block of EDID (first 128 bytes) has 4 blocks of data called DTD. They can either be used to store timing information, or arbitrary data. The 4 DTD blocks are located at bytes 54, 72, 90, and 108. The DTD block which has serial number has first 2 bytes (byte 0, and 1) as zero, 2nd bytes also as zero, and 3rd byte as 0xFF. 4th is again zero. Byte 5 onward has serial number in ASCII. The serial number can occupy a maximum of 13 bytes (byte 5 to 17 of the DTD block). If Serial number is less than 13 characters (13 bytes), then it would be terminated by Line Feed (
0x0A
).
- For the Dell display, it was
00-00-00-FF-00-39-44-52-58-56-36-38-41-30-4C-57-4C-0A
. Note that the serial number has 12 bytes, and is terminated by line feed (0x0A
). Converting 39-44-52-58-56-36-38-41-30-4C-57-4C
to ASCII gives us 9DRXV68A0LWL
.
- Fallback : serial number at byte 12 of EDID. EDID can store Serial number at 2 places, if the DTD block EDID is not found, OS uses the serial number present at bytes 12 to 15 (32 bits little endian). For the Dell display it is (4C-57-4C-30)16, since little endian, the serial number is (304C574C)16, which is (810309452)10. OS will use this value (in base 10 as a fallback) If even this is not present, then
0
is used.
- Manufacture week
- Byte 16 of EDID (can have some variations, see Wikipedia article)
- For the Dell display it is (21)16.
- Fallback :
00
- Manufacture year
- Byte 17 of EDID
- Year of manufacture since 1990. Add 1990 to value at byte 17.
- For the Dell display it is (1A)16. (1A)16 + (1990)10 = (07C6)16
- Fallback :
0000
- Edid base block checksum
- Byte 127 of EDID
- From Wikipedia - Checksum. Sum of all 128 bytes should equal 0 (mod 256).
- No fallback. A valid EDID has to have this value.
Note that only first 128 bytes of EDID is ever required.
A note on fallback
If some of the data required for constructing monitor ID are not present, then OS uses fallback. The fallback for each of the datum required for constructing the monitor ID, as I observed on my Windows 10 machine are given in the list above. I manually edited the EDID of my DELL display (link1 link2, link3 - beware - the method suggested in link 3 may damage your system, proceed only if sure; Link1 is most recommended) to remove all 6 items given above, the monitor ID which OS constructed for me (without MD5 suffix) was @@@0000810309452_00_0000_85
, when I even removed the serial number at byte 12, the monitor ID constructed was @@@00000_00_0000_A4
.
UPDATE 4:
DPI scaling is a property of source, and not of target, hence the id parameter used in DisplayConfigGetDeviceInfo()
, and DisplayConfigSetDeviceInfo()
is the source ID, and not the target ID.
The registry method suggested above should work fine in most cases, but has 2 drawbacks. One is that it doesn't give us parity with system settings app (in terms of the time at which settings are effected). Secondly in some rare cases (not able to repro any more) I have seen that the Monitor ID string generated by OS is slightly different - it has more components that shown in the pic above.
I have successfully created an API which we can use to get/set DPI scaling in exactly the same way, as done by system settings app. Will post in a new answer, as this is more about the approach I took for finding a solution.
UPDATE 5:
The algorithm for generating unique string (monitor IDs) storing DPI of a display is unknown to us but DisplayConfigGetDeviceInfo
can be used with another undocumented parameter: -7
, to construct this, as explained here - https://mcmap.net/q/440875/-how-can-i-change-windows-10-display-scaling-programmatically-using-c