RegisterScaleChangeNotifications 함수(shellscalingapi.h)

크기 조정 정보가 변경될 때 콜백을 받을 창을 등록합니다.

참고 이 함수는 Windows 8.1 현재 지원되지 않습니다. 대신 RegisterScaleChangeEvent 를 사용합니다.

 

구문

HRESULT RegisterScaleChangeNotifications(
  [in]  DISPLAY_DEVICE_TYPE displayDevice,
  [in]  HWND                hwndNotify,
  [in]  UINT                uMsgNotify,
  [out] DWORD               *pdwCookie
);

매개 변수

[in] displayDevice

형식: DISPLAY_DEVICE_TYPE

알림을 받을 표시 디바이스를 나타내는 열거형 값입니다.

[in] hwndNotify

형식: HWND

알림을 받을 창의 핸들입니다.

[in] uMsgNotify

형식: UINT

크기 조정 정보가 변경될 때 hwndNotify 에서 지정한 창에 전달되는 애플리케이션 정의 메시지입니다. 일반적으로 x는 정수 값인 WM_APP+x로 설정해야 합니다.

[out] pdwCookie

형식: DWORD*

이 함수가 성공적으로 반환될 때 등록 토큰을 수신하는 값에 대한 포인터입니다. 이 토큰은 RevokeScaleChangeNotifications를 호출하여 알림을 취소하는 데 사용됩니다.

반환 값

형식: STDAPI

이 함수가 성공하면 S_OK 반환합니다. 그러지 않으면 HRESULT 오류 코드를 반환합니다.

설명

uMsgNotify에서 지정한 이 메시지는 PostMessage를 통해 등록된 창에 게시됩니다. 메시지의 wParam 에는 발생한 변경 사항을 설명하는 SCALE_CHANGE_FLAGS 조합이 포함될 수 있습니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 8 [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2012 [데스크톱 앱만 해당]
대상 플랫폼	Windows
헤더	shellscalingapi.h
DLL	Shcore.dll

추가 정보

GetScaleFactorForMonitor

RegisterScaleChangeEvent

UnregisterScaleChangeEvent