Funzione RegisterScaleChangeEvent (shellscalingapi.h)

Registra per un evento che viene attivato quando la scala è stata modificata. Questa funzione sostituisce RegisterScaleChangeNotifications.

Sintassi

HRESULT RegisterScaleChangeEvent(
  [in]  HANDLE    hEvent,
  [out] DWORD_PTR *pdwCookie
);

Parametri

[in] hEvent

Handle dell'evento da registrare per le notifiche di modifica della scalabilità.

[out] pdwCookie

Quando questa funzione viene restituita correttamente, questo valore riceve l'indirizzo di un puntatore a un cookie che può essere usato in un secondo momento per annullare la registrazione per le notifiche di modifica della scala tramite UnregisterScaleChangeEvent.

Valore restituito

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

Commenti

L'evento viene generato ogni volta che un elemento che può influire sulle modifiche di scala, ma solo perché la scala può essere interessata non significa che sia stata eseguita. I chiamanti possono memorizzare nella cache il fattore di scala per verificare che la scalabilità del monitoraggio sia stata effettivamente modificata. L'handle di eventi verrà duplicato, in modo che i chiamanti possano chiudere l'handle in qualsiasi momento.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 8.1 [solo app desktop]
Server minimo supportato	Windows Server 2012 R2 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	shellscalingapi.h
Libreria	Shcore.lib
DLL	Shcore.dll

Vedi anche

GetScaleFactorForMonitor

UnregisterScaleChangeEvent