Funzione RegisterScaleChangeNotifications (shellscalingapi.h)

Registra una finestra per ricevere i callback quando cambiano le informazioni di ridimensionamento.

Nota Questa funzione non è supportata a partire da Windows 8.1. Usare invece RegisterScaleChangeEvent .

 

Sintassi

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

Parametri

[in] displayDevice

Tipo: DISPLAY_DEVICE_TYPE

Valore di enumerazione che indica il dispositivo di visualizzazione su cui ricevere notifiche.

[in] hwndNotify

Tipo: HWND

Handle della finestra che riceverà le notifiche.

[in] uMsgNotify

Tipo: UINT

Messaggio definito dall'applicazione passato alla finestra specificata da hwndNotify quando cambiano le informazioni di ridimensionamento. In genere, deve essere impostato su WM_APP+x, dove x è un valore intero.

[out] pdwCookie

Tipo: DWORD*

Puntatore a un valore che, quando questa funzione viene restituita correttamente, riceve un token di registrazione. Questo token viene usato per revocare le notifiche chiamando RevokeScaleChangeNotifications.

Valore restituito

Tipo: STDAPI

Se questa funzione ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .

Osservazioni:

Questo messaggio specificato da uMsgNotify viene pubblicato nella finestra registrata tramite PostMessage. Il wParam del messaggio può contenere una combinazione di SCALE_CHANGE_FLAGS che descrivono la modifica che si è verificata.

Requisiti

Requisito	Value
Client minimo supportato	Windows 8 [solo app desktop]
Server minimo supportato	Windows Server 2012 [solo app desktop]
Piattaforma di destinazione	Windows
Header	shellscalingapi.h
Library	OneCore.Lib
DLL	Shcore.dll

Vedere anche

GetScaleFactorForMonitor

RegisterScaleChangeEvent

UnregisterScaleChangeEvent