# MX\_GETDPI

> [HTML Version](mx_getdpi.htm)

_Added October 2020_

**xcall MIAMEX, MX\_GETDPI, sysdpi \{,ctlid, ctldpi\}**

MX\_GETDPI (MIAMEX 197) returns information about the effective or simulated resolution of the workstation monitor(s) in DPI (dots per inch). Applies only to A-Shell/Windows and ATE. 

This function has both a [subroutine and a print tab implementation](subroutine-print-pairs.md).

**Parameters**

_sysdpi_  ([Num](num.md))  \[out\] 

system DPI (primary monitor).

_ctlid_  ([String](string.md) / ([Num](num.md))  \[in\]

optional control ID (name or number) of control for which to return the control's DPI. This will only differ from _sysdpi_ in a multi-monitor system where the control is on one of the secondary monitors.

_ctldpi_  ([Num](num.md))  \[out\]

DPI of the monitor on which the control specified by _ctlid_ is located.

**Comments**

If you don't specify the -dpm command line switch when launching A-Shell/Windows or ATE, the return value will probably be a value simulated by Windows (typically 96) rather than the real resolution of the monitor. The -dpm switch disables the Windows standard resolution simulation, giving access to the actual monitor resolution. See the documentation on the command line switch [DPI Per Monitor Awareness](dpi_per_monitor.md) for more details.

**See Also**

•	[AG\_GETDPI](ag_getdpi.md)

**History**

2020 October, A-Shell 6.5.1692:  Routine added to A-Shell.