RegisterScaleChangeEvent-Funktion (shellscalingapi.h)
Registriert sich für ein Ereignis, das ausgelöst wird, wenn sich die Skalierung möglicherweise geändert hat. Diese Funktion ersetzt RegisterScaleChangeNotifications.
Syntax
HRESULT RegisterScaleChangeEvent(
[in] HANDLE hEvent,
[out] DWORD_PTR *pdwCookie
);
Parameter
[in] hEvent
Handle des Ereignisses, das für Skalierungsänderungsbenachrichtigungen registriert werden soll.
[out] pdwCookie
Wenn diese Funktion erfolgreich zurückgegeben wird, empfängt dieser Wert die Adresse eines Zeigers auf ein Cookie, das später verwendet werden kann, um die Registrierung für die Skalierungsänderungsbenachrichtigungen über UnregisterScaleChangeEvent aufzuheben.
Rückgabewert
Wenn diese Funktion erfolgreich ist, gibt sie S_OK zurück. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.
Hinweise
Das Ereignis wird immer dann ausgelöst, wenn sich etwas ändert, das sich auf die Skalierung auswirken kann, aber nur weil die Skalierung beeinträchtigt werden kann, bedeutet dies nicht, dass dies der Fall war. Aufrufer können den Skalierungsfaktor zwischenspeichern, um zu überprüfen, ob sich die Skalierung des Monitors tatsächlich geändert hat. Das Ereignishandle wird dupliziert, sodass Aufrufer ihr Handle jederzeit schließen können.
Anforderungen
Anforderung | Wert |
---|---|
Unterstützte Mindestversion (Client) | Windows 8.1 [nur Desktop-Apps] |
Unterstützte Mindestversion (Server) | Windows Server 2012 R2 [nur Desktop-Apps] |
Zielplattform | Windows |
Kopfzeile | shellscalingapi.h |
Bibliothek | Shcore.lib |
DLL | Shcore.dll |