Fonction RegisterScaleChangeEvent (shellscalingapi.h)

S’inscrit pour un événement qui est déclenché lorsque l’échelle a peut-être changé. Cette fonction remplace RegisterScaleChangeNotifications.

Syntaxe

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

Paramètres

[in] hEvent

Gérer l’événement pour s’inscrire aux notifications de modification de mise à l’échelle.

[out] pdwCookie

Lorsque cette fonction retourne correctement, cette valeur reçoit l’adresse d’un pointeur vers un cookie qui peut être utilisé ultérieurement pour annuler l’inscription aux notifications de modification de mise à l’échelle via UnregisterScaleChangeEvent.

Valeur retournée

Si cette fonction réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT.

Remarques

L’événement est déclenché chaque fois qu’un élément susceptible d’affecter la mise à l’échelle change, mais le simple fait que l’échelle peut être affectée ne signifie pas qu’elle a été. Les appelants peuvent mettre en cache le facteur de mise à l’échelle pour vérifier que l’échelle du moniteur a bien changé. Le handle d’événement étant dupliqué, les appelants peuvent fermer leur handle à tout moment.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 8.1 [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2012 R2 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	shellscalingapi.h
Bibliothèque	Shcore.lib
DLL	Shcore.dll

Voir aussi

GetScaleFactorForMonitor

DésinscrireScaleChangeEvent