RegisterScaleChangeNotifications-Funktion (shellscalingapi.h)
Registriert ein Fenster, um Rückrufe zu empfangen, wenn sich die Skalierungsinformationen ändern.
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 |