Edit

Share via


GetSystemMetricsForDpi function (winuser.h)

Retrieves the specified system metric or system configuration setting taking into account a provided DPI.

Syntax

int GetSystemMetricsForDpi(
  [in] int  nIndex,
  [in] UINT dpi
);

Parameters

[in] nIndex

The system metric or configuration setting to be retrieved. See GetSystemMetrics for the possible values.

[in] dpi

The DPI to use for scaling the metric.

Return value

If the function succeeds, the return value is nonzero.

If the function fails, the return value is zero. To get extended error information, call GetLastError.

Remarks

This function returns the same result as GetSystemMetrics but scales it according to an arbitrary DPI you provide if appropriate.

Requirements

Requirement Value
Minimum supported client Windows 10, version 1607 [desktop apps only]
Minimum supported server Windows Server 2016 [desktop apps only]
Target Platform Windows
Header winuser.h (include Windows.h)
Library User32.lib
DLL User32.dll
API set ext-ms-win-ntuser-private-l1-3-1 (introduced in Windows 10, version 10.0.14393)