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 指定的窗口。 通常，应将其设置为 WM_APP+x，其中 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