Chiavi del Registro di sistema WCS
WCS usa le chiavi del Registro di sistema per segnalare che si sono verificati determinati eventi del profilo colore. Le app devono eseguire query su queste chiavi del Registro di sistema per ottenere lo stato aggiornato del profilo colore del sistema.
Profilo colore attivo modificato
Le app possono voler rispondere agli eventi di modifica del profilo colore per un dispositivo di monitoraggio; ciò garantisce che abbiano sempre informazioni accurate sul colore per la destinazione, anche se l'utente o un'altra app ha modificato il profilo attivo per il dispositivo.
Applicazioni desktop
Le app desktop devono restare in ascolto delle modifiche apportate al Registro di sistema per determinare quando le associazioni di profili colori sono cambiate usando RegNotifyChangeKeyValue. Un'app deve registrare entrambe le modifiche per l'associazione dei profili utente e per le modifiche a livello di sistema.
RegNotifyChangeKeyValue deve essere inizializzato con un valore HKEY fornito da RegOpenKeyEx. RegOpenKeyEx deve essere inizializzato usando le posizioni dell'albero del Registro di sistema seguenti:
| Associazioni di profili per utente | HKEY_CURRENT_USER SOFTWARE\Microsoft\Windows NT\CurrentVersion\ICM\ProfileAssociations\Display\{4d36e96e-e325-11ce-bfc1-08002be10318} |
| Associazioni di profili a livello di sistema | HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Class\{4d36e96e-e325-11ce-bfc1-08002be10318} |
Quando l'app riceve una notifica di modifica della chiave del Registro di sistema, deve prima eseguire una query se le associazioni per utente o a livello di sistema vengono usate chiamando WcsGetUsePerUserProfiles. Deve quindi chiamare WcsGetDefaultColorProfile con il valore WCS_PROFILE_MANAGEMENT_SCOPE corretto per ottenere il nuovo profilo colore attivo per il monitor. Si noti che non tutte le modifiche apportate alla chiave del Registro di sistema corrispondono a una modifica effettiva nel profilo colore attualmente attivo; l'app mush controlla se il profilo restituito da WcsGetDefaultColorProfile è effettivamente cambiato.
App UWP (Universal Windows)
Le app di Windows universali non hanno accesso alle chiavi del Registro di sistema precedenti. Devono invece registrare un gestore per l'evento DisplayInformation.ColorProfileChanged . Questo evento viene generato ogni volta che il profilo colore attivo per il monitor in cui è in esecuzione l'applicazione è stato modificato. ColorProfileChanged tiene conto se vengono usate associazioni di profili per utente o a livello di sistema; queste informazioni sono astratte dalle app UWP.
Quando risponde all'evento ColorProfileChanged, l'app deve eseguire una query sul profilo attualmente attivo usando DisplayInformation.GetColorProfileAsync.