Функция 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_GETICONMETRICSSPI_GETNONCLIENTMETRICS. Другие возможные значения uiAction не обеспечивают поведение ForDPI, поэтому эта функция возвращает 0 при вызове с ними.

Для значений uiAction , содержащих строки в связанных структурах, в этой функции поддерживаются только строки Юникода (LOGFONTW).

Требования

   
Минимальная версия клиента Windows 10, версия 1607 [только классические приложения]
Минимальная версия сервера Windows Server 2016 [только классические приложения]
Целевая платформа Windows
Header winuser.h (включая Windows.h)
Библиотека User32.lib
DLL User32.dll