RegisterScaleChangeEvent 함수(shellscalingapi.h)

크기 조정이 변경될 수 있을 때 트리거되는 이벤트를 등록합니다. 이 함수는 RegisterScaleChangeNotifications를 대체합니다.

구문

HRESULT RegisterScaleChangeEvent(
  [in]  HANDLE    hEvent,
  [out] DWORD_PTR *pdwCookie
);

매개 변수

[in] hEvent

크기 조정 변경 알림에 등록할 이벤트의 핸들입니다.

[out] pdwCookie

이 함수가 성공적으로 반환되면 이 값은 나중에 UnregisterScaleChangeEvent를 통해 크기 조정 변경 알림을 등록 취소하는 데 사용할 수 있는 쿠키에 대한 포인터의 주소를 받습니다.

반환 값

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

설명

눈금 변경에 영향을 줄 수 있는 항목이 있을 때마다 이벤트가 발생하지만, 눈금이 영향을 받을 수 있다고 해서 이벤트가 발생했음을 의미하지는 않습니다. 호출자는 배율 인수를 캐시하여 모니터의 크기가 실제로 변경되었는지 확인할 수 있습니다. 이벤트 핸들은 복제되므로 호출자는 언제든지 핸들을 닫을 수 있습니다.

요구 사항

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

추가 정보

GetScaleFactorForMonitor

UnregisterScaleChangeEvent