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_GETICONTITLELOGFONTSPI_GETICONMETRICSSPI_GETNONCLIENTMETRICS。 有关这些值的详细信息 ,请参阅 SystemParametersInfo

[in] uiParam

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

[in, out] pvParam

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

[in] fWinIni

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

[in] dpi

用于缩放指标的 DPI。

返回值

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

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

注解

此函数返回与 SystemParametersInfo 类似的结果,但会根据你提供的任意 DPI 进行缩放, ((如果适当)) 。 它仅使用 uiAction 的以下可能值进行缩放:SPI_GETICONTITLELOGFONTSPI_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