Funzione IddCxAdapterSetRenderAdapter (iddcx.h)
IddCxAdapterSetRenderAdapter imposta l'adattatore di rendering preferito su cui eseguire il rendering delle swapchain per l'adattatore specificato.
Sintassi
void IddCxAdapterSetRenderAdapter(
[in] IDDCX_ADAPTER AdapterObject,
[in] const IDARG_IN_ADAPTERSETRENDERADAPTER *pInArgs
);
Parametri
[in] AdapterObject
Oggetto adapter dell'adattatore per il quale viene impostata la preferenza dell'adattatore di rendering.
[in] pInArgs
Puntatore a una struttura IDARG_IN_ADAPTERSETRENDERADAPTER contenente argomenti di input per la funzione.
Valore restituito
Nessuno
Osservazioni
Un driver di visualizzazione indiretto (IDD) può chiamare IddCxAdapterSetRenderAdapter in qualsiasi momento per modificare la scheda di rendering preferita. Il driver può usare l'enumerazione Dxgi per trovare l'adattatore di rendering richiesto LUID.
Il sistema operativo userà la scheda di rendering preferita del driver ID, se possibile. In alcuni casi( ad esempio, quando l'adattatore di rendering preferito è PnpStopped), il sistema operativo può scegliere un adattatore diverso. Il sistema operativo passa l'adattatore di rendering effettivo usato per una porta di scambio al driver nel callback EVT_IDD_CX_MONITOR_ASSIGN_SWAPCHAIN.
iddCxAdapterSetRenderAdapter può essere chiamato in qualsiasi momento per modificare il LUID di rendering. Il sistema operativo tenterà immediatamente di usare questa nuova scheda di rendering per tutti i monitor attivi, ricreando eventuali portachiavi esistenti. Gli utenti potrebbero visualizzare alcuni errori o artefatti visivi quando il sistema operativo riconfigura la composizione desktop. Per evitare glitch, se il driver conosce l'adattatore di rendering da usare in fase di avvio, il driver deve chiamare IddCxAdapterSetRenderAdapter prima di aggiungere monitoraggi e modificarlo solo mentre i percorsi sono attivi se l'utente l'ha richiesta esplicitamente, ad esempio tramite un'applicazione complementare del dispositivo.
IddCxAdapterSetRenderAdapter è supportato sia per le schede console che per gli ID remoti.
Fabbisogno
| Requisito | Valore |
|---|---|
| client minimo supportato | Windows 10, versione 1903 |
| intestazione | iddcx.h |