프로세스에 대한 기본 DPI 인식 설정

  • 아티클

Windows의 데스크톱 애플리케이션은 다른 DPI 인식 모드에서 실행할 수 있습니다. 이러한 모드는 서로 다른 DPI 크기 조정 동작을 사용하도록 설정하고 다른 좌표 공간을 사용할 수 있습니다. DPI 인식에 대한 자세한 내용은 Windows에서 높은 DPI 데스크톱 애플리케이션 개발을 참조하세요. 예기치 않은 동작을 방지하기 위해 프로세스의 기본 DPI 인식 모드를 명시적으로 설정하는 것이 중요합니다.

프로세스의 기본 DPI 인식을 지정하는 두 가지 기본 메서드가 있습니다.

1) 애플리케이션 매니페스트 설정을 통해

2) API 호출을 통해 프로그래밍 방식으로

매니페스트 설정을 통해 기본 프로세스 DPI 인식을 지정하는 것이 좋습니다. API를 통해 기본값을 지정하는 것은 지원되지만 권장되지 않습니다.

애플리케이션 매니페스트를 사용하여 기본 인식 설정

프로세스 기본 DPI 인식 모드 <인 dpiAwareness> 및 <dpiAware>를 지정할 수 있는 두 가지 매니페스트 설정이 있습니다. <dpiAware> 는 Windows Vista에서 도입되었으며 프로세스 기본값만 시스템 인식으로 설정할 수 있습니다. <dpiAwareness>는 Windows 10 버전 1607에서 도입되었으며 프로세스 기본 DPI 인식 모드의 순서가 지정된 목록을 지정할 수 있습니다. 이렇게 하면 애플리케이션이 지정된 첫 번째 인식 모드를 지원할 수 없는 Windows 버전에서 실행되는 경우 사용되는 백업 DPI 인식 모드를 설정할 수 있습니다. 이전 버전의 Windows에서는 최신 <dpiAwareness> 태그가 무시됩니다. 즉, 이러한 매니페스트 설정을 모두 사용하여 Windows 10 버전 1607보다 큰 버전에서 Per-Monitor 동안 프로세스 기본값이 이전 버전의 Windows에서 시스템 인식이 될 수 있는 시나리오를 사용하도록 설정할 수 있습니다. Windows 10 버전 1607 이상에서는 <dpiAwareness> 요소가 있는 경우 <dpiAware> 설정이 무시됩니다.

아래 표에서는 두 매니페스트 설정을 사용하여 다른 프로세스 기본 DPI 인식 모드를 지정하는 방법을 보여 줍니다.

기본 DPI 인식 모드 처리 <dpiAware> 설정 <dpiAwareness> 설정(Windows 10, 버전 1607 이상)
모르고

해당 없음(매니페스트에 dpiAware 설정 없음)

또는

<dpiAware>false</dpiAware>

 <dpiAwareness>인식/<dpiAwareness>
시스템 인식 <dpiAware>true</dpiAware> <dpiAwareness>시스템</dpiAwareness>
모니터당 <dpiAware>true/pm<dpiAware> <dpiAwareness>PerMonitor</dpiAwareness>
모니터당 V2 지원되지 않음 <dpiAwareness>PerMonitorV2</dpiAwareness>

 

아래 샘플에서는 동일한 매니페스트 파일 내에서 사용되는 dpiAwareness> 및 <dpiAware> 설정을 모두 <보여 주세요. 다른 버전의 Windows에 대해 프로세스 기본 DPI 인식 동작을 구성합니다.

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<assembly xmlns="urn:schemas-microsoft-com:asm.v1" manifestVersion="1.0" xmlns:asmv3="urn:schemas-microsoft-com:asm.v3">
  <asmv3:application>
    <asmv3:windowsSettings>
      <dpiAware xmlns="http://schemas.microsoft.com/SMI/2005/WindowsSettings">true</dpiAware>
      <dpiAwareness xmlns="http://schemas.microsoft.com/SMI/2016/WindowsSettings">PerMonitorV2</dpiAwareness>
    </asmv3:windowsSettings>
  </asmv3:application>
</assembly>

프로그래밍 방식으로 기본 인식 설정

권장되지는 않지만 프로그래밍 방식으로 기본 DPI 인식을 설정할 수 있습니다. 프로세스에서 창(HWND)이 만들어지고 나면 DPI 인식 모드 변경이 더 이상 지원되지 않습니다. 프로세스 기본 DPI 인식 모드를 프로그래밍 방식으로 설정하는 경우 HWND를 만들기 전에 해당 API를 호출해야 합니다.

프로세스에 대한 기본 DPI 인식을 지정할 수 있는 여러 API가 있습니다. 이전 API는 더 적은 기능을 제공하므로 현재 권장되는 API는 SetProcessDpiAwarenessContext입니다.

 

API Windows의 최소 버전 DPI 인식 시스템 DPI 인식 모니터별 DPI 인식
SetProcessDPIAware Windows Vista 해당 없음 SetProcessDPIAware() 해당 없음
SetProcessDpiAwareness Windows 8.1 SetProcessDpiAwareness(PROCESS_DPI_UNAWARE) SetProcessDpiAwareness(PROCESS_SYSTEM_DPI_AWARE) SetProcessDpiAwareness(PROCESS_PER_MONITOR_DPI_AWARE)
SetProcessDpiAwarenessContext Windows 10 버전 1607 SetProcessDpiAwarenessContext(DPI_AWARENESS_CONTEXT_UNAWARE) SetProcessDpiAwarenessContext(DPI_AWARENESS_CONTEXT_SYSTEM_AWARE)

SetProcessDpiAwarenessContext(DPI_AWARENESS_CONTEXT_PER_MONITOR_AWARE)

SetProcessDpiAwarenessContext(DPI_AWARENESS_CONTEXT_PER_MONITOR_AWARE_V2)

 

프로세스 기본값과 스레드 기본값 비교

이 문서에서는 프로세스에 대한 기본 DPI 인식 설정을 참조합니다. Windows 10 단일 프로세스 내에서 둘 이상의 DPI 인식 모드를 실행하기 위한 지원을 도입했기 때문입니다(Windows 10 이전에는 전체 프로세스가 단일 DPI 인식 모드를 준수해야 했습니다). 프로세스 내에서 둘 이상의 DPI 인식 모드 실행에 대한 지원을 "혼합 모드 DPI 크기 조정"이라고 합니다. 프로세스 내에서 혼합 모드 DPI 크기 조정을 사용하는 경우 각 최상위 창은 프로세스 기본값과 다를 수 있는 DPI 인식 모드에서 실행할 수 있습니다. 명시적으로 지정하지 않는 한 각 스레드는 만들 때 기본적으로 프로세스 기본값으로 설정됩니다. 혼합 모드 DPI 크기 조정에 대한 자세한 내용은 혼합 모드 DPI 크기 조정 문서를 참조하세요.