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 |