SystemParametersInfoForDpi-Funktion (winuser.h)

  • Artikel

Ruft den Wert eines der systemweiten Parameter unter Berücksichtigung des angegebenen DPI-Werts ab.

Syntax

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

Parameter

[in] uiAction

Der systemweite Parameter, der abgerufen werden soll. Diese Funktion ist nur für die Verwendung mit SPI_GETICONTITLELOGFONT, SPI_GETICONMETRICS oder SPI_GETNONCLIENTMETRICS vorgesehen. Weitere Informationen zu diesen Werten finden Sie unter SystemParametersInfo .

[in] uiParam

Ein Parameter, dessen Verwendung und Format vom abgefragten Systemparameter abhängen. Weitere Informationen zu systemweiten Parametern finden Sie im uiAction-Parameter . Wenn nicht anders angegeben, müssen Sie null für diesen Parameter angeben.

[in, out] pvParam

Ein Parameter, dessen Verwendung und Format vom abgefragten Systemparameter abhängen. Weitere Informationen zu systemweiten Parametern finden Sie im uiAction-Parameter . Wenn nicht anders angegeben, müssen Sie null für diesen Parameter angeben. Informationen zum PVOID-Datentyp finden Sie unter Windows-Datentypen.

[in] fWinIni

Hat keine Auswirkungen für diese API. Dieser Parameter wirkt sich nur dann aus, wenn Sie parameter festlegen.

[in] dpi

Der DPI, der zum Skalieren der Metrik verwendet werden soll.

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert ungleich Null.

Wenn die Funktion fehlerhaft ist, ist der Rückgabewert null. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.

Hinweise

Diese Funktion gibt ein ähnliches Ergebnis wie SystemParametersInfo zurück, skaliert es jedoch nach einem beliebigen DPI, den Sie (falls zutreffend) angeben. Es wird nur mit den folgenden möglichen Werten für uiAction skaliert: SPI_GETICONTITLELOGFONT, SPI_GETICONMETRICS, SPI_GETNONCLIENTMETRICS. Andere mögliche uiAction-Werte bieten kein ForDPI-Verhalten, und daher gibt diese Funktion 0 zurück, wenn sie mit ihnen aufgerufen wird.

Für uiAction-Werte , die Zeichenfolgen in den zugeordneten Strukturen enthalten, werden in dieser Funktion nur Unicode-Zeichenfolgen (LOGFONTW) unterstützt.

Anforderungen

   
Unterstützte Mindestversion (Client) Windows 10, Version 1607 [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2016 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile winuser.h (einschließlich Windows.h)
Bibliothek User32.lib
DLL User32.dll