Funzione IddCxAdapterDisplayConfigUpdate2 (iddcx.h)
Un driver remoto può chiamare IddCxAdapterDisplayConfigUpdate2 per consentire a un client di indicare al server come aggiornare la configurazione del monitoraggio.
Sintassi
HRESULT IddCxAdapterDisplayConfigUpdate2(
IDDCX_ADAPTER AdapterObject,
const IDARG_IN_ADAPTERDISPLAYCONFIGUPDATE2 *pInArgs
);
Parametri
AdapterObject
[in] Oggetto IDDCX_ADAPTER della scheda remota per cui è specificata la configurazione di visualizzazione.
pInArgs
[in] Puntatore a una struttura IDARG_IN_ADAPTERDISPLAYCONFIGUPDATE2 contenente argomenti di input per la funzione.
Valore restituito
IddCxAdapterDisplayConfigUpdate2 restituisce STATUS_SUCCESS in caso di esito positivo; in caso contrario, restituisce un codice di errore appropriato.
Commenti
Un driver di visualizzazione indiretto remoto può chiamare IddCxAdapterDisplayConfigUpdate2 per impostare la modalità, i colorimetria e altri valori che il sistema operativo deve usare per un monitoraggio specifico. Solo i driver remoti sono in grado di chiamare questa funzione.
Per altre informazioni sul supporto HDR, vedi Aggiornamenti di IddCx versione 1.10.
La struttura IDDCX_DISPLAYCONFIGPATH2 è definita in modo tale che non tutte le informazioni devono essere fornite in ogni chiamata. Ad esempio, alcuni percorsi potrebbero non fornire dati colorimetria se la modalità colore non è HDR o WCG o IddCxAdapterDisplayConfigUpdate2 potrebbe essere chiamata per aggiornare il livello bianco SDR solo se non sono necessarie modifiche al layout.
Le modalità di controllo (impostazione del flag di IDDCX_DISPLAYCONFIGPATH2_FLAGS_MODE_VALID per un percorso) presentano alcune regole aggiuntive e chiarimenti:
- Se un percorso ha IDDCX_DISPLAYCONFIGPATH2_FLAGS_MODE_VALID impostato, tutti i percorsi specificati devono essere impostati
- Quando IDDCX_DISPLAYCONFIGPATH2_FLAGS_MODE_VALID viene fornito su tutti i percorsi, tutti i percorsi attualmente attivi non nell'elenco di percorsi diventeranno inattivi
- Se vengono impostati solo flag non IDDCX_DISPLAYCONFIGPATH2_FLAGS_MODE_VALID , devono essere presenti solo i percorsi da aggiornare
- A seconda della modalità colore specificata, potrebbero essere necessari dati aggiuntivi per un percorso. La tabella seguente indica quali flag aggiuntivi devono essere impostati:
| Modalità colore | IDDCX_DISPLAYCONFIGPATH2_FLAGS_MONITOR_COLORIMETRY_VALID | IDDCX_DISPLAYCONFIGPATH2_FLAGS_MONITOR_SDRWHITELEVEL_VALID |
|---|---|---|
| SDR | No | No |
| SDRWCG | Sì | No |
| HDR | Sì | Sì |
Prima rispetto alle chiamate successive a IddCxAdapterDisplayConfigUpdate2
La prima volta che un percorso viene incluso in una chiamata IddCxAdapterDisplayConfigUpdate2 ha requisiti diversi rispetto ai tempi successivi. Nella tabella seguente vengono descritti i requisiti.
| Campo Percorso | Obbligatorio nella chiamata iniziale per il percorso | Può essere aggiornato dopo la chiamata iniziale | Come ottenere le informazioni dal client Windows |
|---|---|---|---|
| Mode | Sì | Sì | QueryDisplayConfig fornirà la configurazione di visualizzazione del client e WM_DISPLAYCHANGE viene inviato quando viene modificata la configurazione di visualizzazione; AdvancedColorInfo.CurrentAdvancedColorKind fornirà una modalità colore |
| Fattore di scala | Sì | Sì | I driver possono usare il metodo usato per IddCxAdapterDisplayConfigUpdate |
| Dimensioni fisiche | Sì se non è stato passato alcun EDID | No | Non necessario se è stato passato EDID |
| Colorimetria | Sì per la modalità colore non SDR | Sì | Maggior parte dei campi dai campi AdvancedColorInfo corrispondenti |
| Livello bianco SDR | Sì per la modalità colore HDR, il valore predefinito è 80 nit | Sì | AdvancedColorInfo.SdrWhiteLevelInNits, vedere DirectX with Advanced Color on HDR/SDR display (DirectX with Advanced Color on HDR/SDR display ) per altre informazioni |
Differenze di comportamento durante l'esecuzione in Windows 11, aggiornamento di settembre 22H2
A causa della funzionalità del sistema operativo sottostante, il supporto per i driver che richiedono modalità colori HDR e WCG durante l'esecuzione in Windows 11, l'aggiornamento di settembre 22H2 è leggermente diverso rispetto a quando viene eseguito nella versione della piattaforma Windows disponibile nel 2024. Un driver può usare la funzione IddCxGetVersion per determinare il sistema operativo in cui sono in esecuzione. La tabella seguente descrive le modalità colore che un driver può richiedere a seconda del descrittore di monitoraggio fornito in precedenza al sistema operativo:
| Tipo Edid | 22H2 Settembre Aggiornamento possibili modalità colore | Versione della piattaforma nelle modalità colore possibili 2024 |
|---|---|---|
| Nessuno | SDR, HDR | SDR, SDRWCG, HDR |
| SDR | SDR, SDRWCG | SDR, SDRWCG |
| HDR | SDR, HDR | SDR, SDRWCG, HDR |
Esempio
Di seguito sono riportati alcuni esempi dei percorsi da includere nelle chiamate IddCxAdapterDisplayConfigUpdate2 successive. All'inizio di ogni scenario, per una sessione remota sono configurati i percorsi seguenti:
| Monitoraggio | Risoluzione | Posizione desktop | Modalità colore |
|---|---|---|---|
| 1 | 1920x1080 a 30Hz | 0,0 | SDR |
| 2 | 1024x768 a 30Hz | 1024,0 | SDRWCG |
| 3 | 3840x2160 a 30Hz | 0,1848 | HDR |
Scenario 1- Modificare la posizione desktop di Monitoraggio 3 a sinistra di Monitoraggio 1
| Monitoraggio | Flags | Dettagli |
|---|---|---|
| 1 | IDDCX_DISPLAYCONFIGPATH2_FLAGS_MODE_VALID | Nessuna modifica ai dati in modalità corrente |
| 2 | IDDCX_DISPLAYCONFIGPATH2_FLAGS_MODE_VALID | Nessuna modifica ai dati in modalità corrente |
| 3 | IDDCX_DISPLAYCONFIGPATH2_FLAGS_MODE_VALID | Modificare la posizione del desktop in -3840.0 |
Scenario 2 : Modificare il monitoraggio 2 da SDRWCG a SDR
| Monitoraggio | Flags | Dettagli |
|---|---|---|
| 1 | IDDCX_DISPLAYCONFIGPATH2_FLAGS_MODE_VALID | Nessuna modifica ai dati in modalità corrente |
| 2 | IDDCX_DISPLAYCONFIGPATH2_FLAGS_MODE_VALID | Impostare la nuova modalità colore |
| 3 | IDDCX_DISPLAYCONFIGPATH2_FLAGS_MODE_VALID | Nessuna modifica ai dati in modalità corrente |
Scenario 3 : Modificare il monitoraggio 1 da SDR a HDR
| Monitoraggio | Flags | Dettagli |
|---|---|---|
| 1 | IDDCX_DISPLAYCONFIGPATH2_FLAGS_MODE_VALID, IDDCX_DISPLAYCONFIGPATH2_FLAGS_MONITOR_COLORIMETRY_VALID, IDDCX_DISPLAYCONFIGPATH2_FLAGS_MONITOR_SDRWHITELEVEL_VALID | Impostare nuova modalità colore, colorimetria e livello bianco SDR |
| 2 | IDDCX_DISPLAYCONFIGPATH2_FLAGS_MODE_VALID | Nessuna modifica ai dati in modalità corrente |
| 3 | IDDCX_DISPLAYCONFIGPATH2_FLAGS_MODE_VALID | Nessuna modifica ai dati in modalità corrente |
Scenario 4 - Fattore di scalabilità di modifica di Monitor 2
| Monitoraggio | Flags | Dettagli |
|---|---|---|
| 2 | IDDCX_DISPLAYCONFIGPATH2_FLAGS_MONITOR_SCALE_FACTOR_VALID | Impostare un nuovo fattore di scala |
Scenario 5 : Modificare il fattore di scala di Monitor 2 e la posizione desktop di Monitor 3 da sinistra di Monitor 1
| Monitoraggio | Flags | Dettagli |
|---|---|---|
| 1 | IDDCX_DISPLAYCONFIGPATH2_FLAGS_MODE_VALID | Nessuna modifica ai dati in modalità corrente |
| 2 | IDDCX_DISPLAYCONFIGPATH2_FLAGS_MODE_VALID, IDDCX_DISPLAYCONFIGPATH2_FLAGS_MONITOR_SCALE_FACTOR_VALID | Nessuna modifica ai dati in modalità corrente, impostare un nuovo fattore di scala |
| 3 | IDDCX_DISPLAYCONFIGPATH2_FLAGS_MODE_VALID | Modificare la posizione del desktop in -3840.0 |
Scenario 6: rimuovere Monitoraggio 2 dalla configurazione corrente
| Monitoraggio | Flags | Dettagli |
|---|---|---|
| 1 | IDDCX_DISPLAYCONFIGPATH2_FLAGS_MODE_VALID | Nessuna modifica ai dati in modalità corrente |
| 3 | IDDCX_DISPLAYCONFIGPATH2_FLAGS_MODE_VALID | Nessuna modifica ai dati in modalità corrente |
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows 11, versione 22H2 Settembre Update (IddCx versione 1.10) |
| Intestazione | iddcx.h |
Vedi anche
Commenti e suggerimenti
Presto disponibile: Nel corso del 2024 verranno gradualmente disattivati i problemi di GitHub come meccanismo di feedback per il contenuto e ciò verrà sostituito con un nuovo sistema di feedback. Per altre informazioni, vedere https://aka.ms/ContentUserFeedback.
Invia e visualizza il feedback per