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 行為，因此，如果使用 ForDPI 呼叫，則此函式會傳回 0。

針對在其相關聯結構中包含字串的 uiAction 值，此函式僅支援 Unicode (LOGFONTW) 字串。

規格需求

最低支援的用戶端	Windows 10版本 1607 [僅限傳統型應用程式]
最低支援的伺服器	Windows Server 2016 [僅限傳統型應用程式]
目標平台	Windows
標頭	winuser.h (包括 Windows.h)
程式庫	User32.lib
Dll	User32.dll