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 매개 변수를 참조하세요. 달리 표시되지 않으면 이 매개 변수에 대해 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 값의 경우 이 함수에서 유니코드(LOGFONTW) 문자열만 지원됩니다.

요구 사항

지원되는 최소 클라이언트	Windows 10 버전 1607 [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2016 [데스크톱 앱만 해당]
대상 플랫폼	Windows
헤더	winuser.h(Windows.h 포함)
라이브러리	User32.lib
DLL	User32.dll