RegisterScaleChangeEvent 函数 (shellscalingapi.h)
注册在缩放可能更改时触发的事件。 此函数替换 RegisterScaleChangeNotifications。
语法
HRESULT RegisterScaleChangeEvent(
[in] HANDLE hEvent,
[out] DWORD_PTR *pdwCookie
);
参数
[in] hEvent
要注册缩放更改通知的事件的句柄。
[out] pdwCookie
当此函数成功返回时,此值接收指向 Cookie 的指针的地址,该 Cookie 稍后可用于通过 UnregisterScaleChangeEvent 取消注册缩放更改通知。
返回值
如果此函数成功,则返回 S_OK。 否则,将返回 HRESULT 错误代码。
注解
每当可能影响缩放更改的内容时,都会引发事件,但仅仅因为缩放可能受到影响并不意味着它已发生。 调用方可以缓存缩放因子,以验证监视器的比例是否确实发生了更改。 事件句柄将重复,因此调用方可以随时关闭其句柄。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows 8.1 [仅限桌面应用] |
最低受支持的服务器 | Windows Server 2012 R2 [仅限桌面应用] |
目标平台 | Windows |
标头 | shellscalingapi.h |
Library | Shcore.lib |
DLL | Shcore.dll |