Fonction SystemParametersInfoForDpi (winuser.h)

Article
11/05/2023

Récupère la valeur de l’un des paramètres à l’échelle du système, en tenant compte de la valeur DPI fournie.

Syntaxe

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

Paramètres

[in] uiAction

Paramètre à l’échelle du système à récupérer. Cette fonction est uniquement destinée à être utilisée avec SPI_GETICONTITLELOGFONT, SPI_GETICONMETRICS ou SPI_GETNONCLIENTMETRICS. Pour plus d’informations sur ces valeurs , consultez SystemParametersInfo .

[in] uiParam

Paramètre dont l’utilisation et le format dépendent du paramètre système interrogé. Pour plus d’informations sur les paramètres à l’échelle du système, consultez le paramètre uiAction . S’il n’est pas indiqué autrement, vous devez spécifier zéro pour ce paramètre.

[in, out] pvParam

[in] fWinIni

N’a aucun effet pour avec cette API. Ce paramètre a un effet uniquement si vous définissez le paramètre.

[in] dpi

Ppp à utiliser pour la mise à l’échelle de la métrique.

Valeur retournée

Si la fonction réussit, la valeur de retour est différente de zéro.

Si la fonction échoue, la valeur de retour est égale à zéro. Pour obtenir des informations détaillées sur l’erreur, appelez GetLastError.

Remarques

Cette fonction retourne un résultat similaire à celui de SystemParametersInfo, mais le met à l’échelle en fonction d’un ppp arbitraire que vous fournissez (le cas échéant). Il est mis à l’échelle uniquement avec les valeurs possibles suivantes pour uiAction : SPI_GETICONTITLELOGFONT, SPI_GETICONMETRICS, SPI_GETNONCLIENTMETRICS. D’autres valeurs uiAction possibles ne fournissent pas de comportement ForDPI. Par conséquent, cette fonction retourne 0 si elle est appelée avec elles.

Pour les valeurs uiAction qui contiennent des chaînes dans leurs structures associées, seules les chaînes Unicode (LOGFONTW) sont prises en charge dans cette fonction.

Configuration requise


Client minimal pris en charge	Windows 10, version 1607 [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2016 (applications de bureau uniquement)
Plateforme cible	Windows
En-tête	winuser.h (inclure Windows.h)
Bibliothèque	User32.lib
DLL	User32.dll

Partager via