SystemParametersInfoForDpi 函数 (winuser.h)

检索其中一个系统范围的参数的值，同时考虑提供的 DPI 值。

语法

BOOL SystemParametersInfoForDpi(
  [in]      UINT  uiAction,
  [in]      UINT  uiParam,
  [in, out] PVOID pvParam,
  [in]      UINT  fWinIni,
  [in]      UINT  dpi
);

参数

[in] uiAction

要检索的系统范围参数。 此函数仅适用于 SPI_GETICONTITLELOGFONT、 SPI_GETICONMETRICS或 SPI_GETNONCLIENTMETRICS。 有关这些值的详细信息 ，请参阅 SystemParametersInfo 。

[in] uiParam

一个参数，其用法和格式取决于正在查询的系统参数。 有关系统范围参数的详细信息，请参阅 uiAction 参数。 如果未另行指示，则必须为此参数指定零。

[in, out] pvParam

一个参数，其用法和格式取决于正在查询的系统参数。 有关系统范围参数的详细信息，请参阅 uiAction 参数。 如果未另行指示，则必须为此参数指定 NULL 。 有关 PVOID 数据类型的信息，请参阅 Windows 数据类型。

[in] fWinIni

对此 API 不起作用。 仅当你正在设置参数时，此参数才有效。

[in] dpi

用于缩放指标的 DPI。

返回值

如果该函数成功，则返回值为非零值。

如果函数失败，则返回值为零。 要获得更多的错误信息，请调用 GetLastError。

注解

此函数返回与 SystemParametersInfo 类似的结果，但会根据你提供的任意 DPI 进行缩放， (（如果适当）) 。 它仅使用 uiAction 的以下可能值进行缩放：SPI_GETICONTITLELOGFONT、SPI_GETICONMETRICS、SPI_GETNONCLIENTMETRICS。 其他可能的 uiAction 值不提供 ForDPI 行为，因此，如果用它们调用，此函数将返回 0。

对于在其关联结构中包含字符串的 uiAction 值，此函数仅支持 Unicode (LOGFONTW) 字符串。

要求

最低受支持的客户端	Windows 10版本 1607 [仅限桌面应用]
最低受支持的服务器	Windows Server 2016 [仅限桌面应用]
目标平台	Windows
标头	winuser.h (包括 Windows.h)
Library	User32.lib
DLL	User32.dll