Fonction SystemParametersInfoForDpi (winuser.h)

  • Article

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

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 NULL pour ce paramètre. Pour plus d’informations sur le type de données PVOID , consultez Types de données Windows.

[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