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 |