RegisterScaleChangeNotifications-Funktion (shellscalingapi.h)

Registriert ein Fenster, um Rückrufe zu empfangen, wenn sich die Skalierung von Informationen ändert.

Syntax

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

Die 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 Nachricht, die an das durch 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, wenn diese Funktion erfolgreich zurückgegeben wird, 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 HRESULT-Fehlercode zurückgegeben.

Bemerkungen

Diese von uMsgNotify angegebene Nachricht wird über PostMessage in das registrierte Fenster gepostet. Die wParam der Nachricht kann eine Kombination aus SCALE_CHANGE_FLAGS enthalten, die die aufgetretene Änderung beschreiben.

Anforderungen

Siehe auch

GetScaleFactorForMonitor

RegisterScaleChangeEvent

UnregisterScaleChangeEvent