RegisterScaleChangeEvent 函数 (shellscalingapi.h)

注册在缩放可能更改时触发的事件。此函数替换 RegisterScaleChangeNotifications。

语法

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

[in] hEvent

要注册缩放更改通知的事件的句柄。

[out] pdwCookie

当此函数成功返回时，此值接收指向 Cookie 的指针的地址，该 Cookie 稍后可用于通过 UnregisterScaleChangeEvent 取消注册缩放更改通知。

如果此函数成功，则返回 S_OK。否则，将返回 HRESULT 错误代码。

每当可能影响缩放更改的内容时，都会引发事件，但仅仅因为缩放可能受到影响并不意味着它已发生。调用方可以缓存缩放因子，以验证监视器的比例是否确实发生了更改。事件句柄将重复，因此调用方可以随时关闭其句柄。