IddCxAdapterSetRenderAdapter-Funktion (iddcx.h)
IddCxAdapterSetRenderAdapter legt den bevorzugten Renderadapter fest, auf dem die Swapchains für den angegebenen Adapter gerendert werden sollen.
Syntax
void IddCxAdapterSetRenderAdapter(
[in] IDDCX_ADAPTER AdapterObject,
[in] const IDARG_IN_ADAPTERSETRENDERADAPTER *pInArgs
);
Parameter
[in] AdapterObject
Adapterobjekt des Adapters, für den die Einstellung des Renderingadapters festgelegt wird.
[in] pInArgs
Zeigen Sie auf eine IDARG_IN_ADAPTERSETRENDERADAPTER Struktur, die Eingabeargumente auf die Funktion enthält.
Rückgabewert
Nichts
Bemerkungen
Ein indirekter Anzeigetreiber (IDD) kann IddCxAdapterSetRenderAdapter jederzeit aufrufen, um den bevorzugten Renderadapter zu ändern. Der Treiber kann die Dxgi-Aufzählung verwenden, um die erforderliche RENDERadapter-LUID zu finden.
Das Betriebssystem verwendet nach Möglichkeit den bevorzugten Renderadapter des ID-Treibers. In einigen Fällen (z. B. wenn der bevorzugte Renderadapter PnpStopped ist), kann das Betriebssystem einen anderen Adapter auswählen. Das Betriebssystem übergibt den tatsächlichen Renderadapter, der für eine Swapchain verwendet wird, an den Treiber im EVT_IDD_CX_MONITOR_ASSIGN_SWAPCHAIN Rückruf.
IddCxAdapterSetRenderAdapter kann jederzeit aufgerufen werden, um die Render-LUID zu ändern. Das Betriebssystem versucht sofort, diesen neuen Renderadapter für alle aktiven Monitore zu verwenden und alle vorhandenen Swapchains neu zu erstellen. Benutzer sehen möglicherweise einige visuelle Störungen/Artefakte, da das Betriebssystem die Desktopkomposition neu konfiguriert. Um Störungen zu vermeiden, sollte der Treiber IddCxAdapterSetRenderAdapter aufrufen, bevor er Monitore hinzufügt und nur ändert, wenn pfade aktiv sind, wenn der Benutzer ihn explizit angefordert hat, z. B. über eine Geräte-Begleitanwendung.
IddCxAdapterSetRenderAdapter wird sowohl für Konsolen- als auch für Remote-ID-Adapter unterstützt.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Windows 10, Version 1903 |
| Header- | iddcx.h |