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.
Osservazioni
Un driver di visualizzazione indiretto remoto può chiamare IddCxAdapterDisplayConfigUpdate2 per impostare la modalità, i colorimetry e altri valori che il sistema operativo deve usare per un monitor specifico. Solo i driver remoti sono in grado di chiamare questa funzione.
Per altre informazioni sul supporto HDR, vedere aggiornamenti iddCx versione 1.10.
La struttura IDDCX_DISPLAYCONFIGPATH2 è definita in modo 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 chiamato 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 e chiarimenti aggiuntivi:
- 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 in tutti i percorsi, tutti i percorsi attualmente attivi non nell'elenco di percorsi diventeranno inattivi
- Se vengono impostati solo flag nonIDDCX_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 un IddCxAdapterDisplayConfigUpdate2 chiamata 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 sul client Windows |
|---|---|---|---|
| Modo | Sì | Sì | queryDisplayConfig fornirà la configurazione della visualizzazione client e WM_DISPLAYCHANGE viene inviato quando si visualizzano le modifiche alla configurazione; 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 EDID è stato passato |
| Colorimetria | Sì per la modalità colore non SDR | Sì | La maggior parte dei campi dei campi AdvancedColorInfo corrispondenti |
| Livello bianco SDR | Sì per la modalità colore HDR, il valore predefinito è 80 nits | Sì | AdvancedColorInfo.SdrWhiteLevelInNits, vedere DirectX con colore avanzato nei display HDR/SDR per altre informazioni |
Differenze di comportamento durante l'esecuzione nell'aggiornamento di settembre di Windows 11, versione 22H2
A causa delle funzionalità del sistema operativo sottostanti, il supporto per i driver che richiedono le modalità di colore HDR e WCG durante l'esecuzione in Windows 11, versione 22H2 Settembre Update è leggermente diverso rispetto a quando è in esecuzione nella versione della piattaforma Windows in arrivo nel 2024. Un driver può usare la funzioneIddCxGetVersionper determinare il sistema operativo in cui sono in esecuzione. La tabella seguente descrive le modalità di colore che un driver può richiedere a seconda del descrittore di monitoraggio fornito in precedenza al sistema operativo:
| Tipo Edid | 22H2 Aggiornamento di settembre 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 |
Esempi
Di seguito sono riportati alcuni esempi di percorsi da includere nelle chiamate successive IddCxAdapterDisplayConfigUpdate2. All'inizio di ogni scenario, per una sessione remota sono configurati i percorsi seguenti:
| Monitor | 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 del desktop di Monitor 3 a sinistra di Monitor 1
| Monitor | Bandiere | 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
| Monitor | Bandiere | 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 monitor 1 da SDR a HDR
| Monitor | Bandiere | Dettagli |
|---|---|---|
| 1 | IDDCX_DISPLAYCONFIGPATH2_FLAGS_MODE_VALID, IDDCX_DISPLAYCONFIGPATH2_FLAGS_MONITOR_COLORIMETRY_VALID, IDDCX_DISPLAYCONFIGPATH2_FLAGS_MONITOR_SDRWHITELEVEL_VALID | Impostare la 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 scala delle modifiche di Monitoraggio 2
| Monitor | Bandiere | 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 a sinistra di Monitor 1
| Monitor | Bandiere | 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
| Monitor | Bandiere | 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 |
Fabbisogno
| Requisito | Valore |
|---|---|
| client minimo supportato | Aggiornamento di settembre di Windows 11, versione 22H2 (IddCx versione 1.10) |
| intestazione | iddcx.h |