Skip to content

Latest commit

 

History

History
106 lines (76 loc) · 3.83 KB

nf-shellscalingapi-registerscalechangenotifications.md

File metadata and controls

106 lines (76 loc) · 3.83 KB
UID title description helpviewer_keywords old-location tech.root ms.assetid ms.date ms.keywords req.header req.include-header req.target-type req.target-min-winverclnt req.target-min-winversvr req.kmdf-ver req.umdf-ver req.ddi-compliance req.unicode-ansi req.idl req.max-support req.namespace req.assembly req.type-library req.lib req.dll req.irql targetos req.typenames req.redist ms.custom f1_keywords dev_langs topic_type api_type api_location api_name
NF:shellscalingapi.RegisterScaleChangeNotifications
RegisterScaleChangeNotifications function (shellscalingapi.h)
Registers a window to receive callbacks when scaling information changes.
RegisterScaleChangeNotifications
RegisterScaleChangeNotifications function [Windows Shell]
shell.RegisterScaleChangeNotifications
shellscalingapi/RegisterScaleChangeNotifications
shell\RegisterScaleChangeNotifications.htm
shell
79FB0A54-EBF0-4aab-B631-B4D3EA54D20B
12/05/2018
RegisterScaleChangeNotifications, RegisterScaleChangeNotifications function [Windows Shell], shell.RegisterScaleChangeNotifications, shellscalingapi/RegisterScaleChangeNotifications
shellscalingapi.h
Windows
Windows 8 [desktop apps only]
Windows Server 2012 [desktop apps only]
Shcore.dll
Windows
19H1
RegisterScaleChangeNotifications
shellscalingapi/RegisterScaleChangeNotifications
c++
APIRef
kbSyntax
DllExport
Shcore.dll
API-MS-Win-shcore-scaling-l1-1-0.dll
API-MS-Win-shcore-scaling-l1-1-1.dll
API-MS-Win-ShCore-Scaling-l1-1-2.dll
api-ms-win-shcore-scaling-l1.dll
RegisterScaleChangeNotifications

RegisterScaleChangeNotifications function

-description

Registers a window to receive callbacks when scaling information changes.

Note  This function is not supported as of Windows 8.1. Use RegisterScaleChangeEvent instead.
 

-parameters

-param displayDevice [in]

Type: DISPLAY_DEVICE_TYPE

The enum value that indicates which display device to receive notifications about.

-param hwndNotify [in]

Type: HWND

The handle of the window that will receive the notifications.

-param uMsgNotify [in]

Type: UINT

An application-defined message that is passed to the window specified by hwndNotify when scaling information changes. Typically, this should be set to WM_APP+x, where x is an integer value.

-param pdwCookie [out]

Type: DWORD*

Pointer to a value that, when this function returns successfully, receives a registration token. This token is used to revoke notifications by calling RevokeScaleChangeNotifications.

-returns

Type: STDAPI

If this function succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.

-remarks

This message specified by uMsgNotify is posted to the registered window through PostMessage. The wParam of the message can contain a combination of SCALE_CHANGE_FLAGS that describe the change that occurred.

-see-also

GetScaleFactorForMonitor

RegisterScaleChangeEvent

UnregisterScaleChangeEvent