SystemParametersInfoForDpi 関数 (winuser.h)

指定された DPI 値を考慮して、システム全体のパラメーターの 1 つの値を取得します。

構文

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 パラメーターに関するページを参照してください。 それ以外の場合は、このパラメーターに 0 を指定する必要があります。

[in, out] pvParam

使用と形式がクエリ対象のシステム パラメーターに依存するパラメーター。 システム全体のパラメーターの詳細については、 uiAction パラメーターに関するページを参照してください。 それ以外の場合は、このパラメーターに NULL を 指定する必要があります。 PVOID データ型の詳細については、「Windows データ型」を参照してください。

[in] fWinIni

この API には効果がありません。 このパラメーターは、パラメーターを設定している場合にのみ有効です。

[in] dpi

メトリックのスケーリングに使用する DPI。

戻り値

関数が成功すると、戻り値は 0 以外になります。

関数が失敗した場合は、0 を返します。 詳細なエラー情報を得るには、GetLastError を呼び出します。

解説

この関数は SystemParametersInfo と同様の結果を返しますが、指定した任意の DPI (必要に応じて) に従ってスケーリングします。 uiAction の使用可能な値は、SPI_GETICONTITLELOGFONT、SPI_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