RegisterScaleChangeNotifications 函数(shellscalingapi.h)

注册一个窗口,以在缩放信息更改时接收回调。

注意 自 Windows 8.1 起,不支持此函数。 请改用 RegisterScaleChangeEvent
 

Syntax

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 的组合。

要求

Requirement 价值
最低支持的客户端 Windows 8 [仅限桌面应用]
支持的最低服务器 Windows Server 2012 [仅限桌面应用]
目标平台 Windows操作系统
Header shellscalingapi.h
Library OneCore.Lib
DLL Shcore.dll

另请参阅

GetScaleFactorForMonitor

RegisterScaleChangeEvent

UnregisterScaleChangeEvent