RegisterScaleChangeEvent-Funktion (shellscalingapi.h)

  • Artikel

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

Weitere Informationen

GetScaleFactorForMonitor

Aufheben der RegistrierungscaleChangeEvent