RegisterScaleChangeNotifications-Funktion (shellscalingapi.h)

  • Artikel

Registriert ein Fenster, um Rückrufe zu empfangen, wenn sich die Skalierungsinformationen ändern.

Hinweis Diese Funktion wird ab Windows 8.1 nicht unterstützt. Verwenden Sie stattdessen RegisterScaleChangeEvent .
 

Syntax

HRESULT RegisterScaleChangeNotifications(
  [in]  DISPLAY_DEVICE_TYPE displayDevice,
  [in]  HWND                hwndNotify,
  [in]  UINT                uMsgNotify,
  [out] DWORD               *pdwCookie
);

Parameter

[in] displayDevice

Typ: DISPLAY_DEVICE_TYPE

Der Enumerationswert, der angibt, über welches Anzeigegerät Benachrichtigungen empfangen werden sollen.

[in] hwndNotify

Typ: HWND

Das Handle des Fensters, das die Benachrichtigungen empfängt.

[in] uMsgNotify

Typ: UINT

Eine anwendungsdefinierte Meldung, die an das von hwndNotify angegebene Fenster übergeben wird, wenn sich die Skalierungsinformationen ändern. In der Regel sollte dies auf WM_APP+x festgelegt werden, wobei x ein ganzzahliger Wert ist.

[out] pdwCookie

Typ: DWORD*

Zeiger auf einen Wert, der nach erfolgreicher Rückgabe dieser Funktion ein Registrierungstoken empfängt. Dieses Token wird verwendet, um Benachrichtigungen durch Aufrufen von RevokeScaleChangeNotifications zu widerrufen.

Rückgabewert

Typ: STDAPI

Wenn diese Funktion erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Hinweise

Diese von uMsgNotify angegebene Nachricht wird über PostMessage im registrierten Fenster bereitgestellt. Die wParam der Nachricht kann eine Kombination aus SCALE_CHANGE_FLAGS enthalten, die die aufgetretene Änderung beschreiben.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 8 [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2012 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile shellscalingapi.h
DLL Shcore.dll

Weitere Informationen

GetScaleFactorForMonitor

RegisterScaleChangeEvent

UnregisterScaleChangeEvent