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 Renderingadaptereinstellung festgelegt wird.

[in] pInArgs

Zeiger auf eine IDARG_IN_ADAPTERSETRENDERADAPTER-Struktur , die Eingabeargumente auf die Funktion enthält.

Rückgabewert

Keine

Bemerkungen

Ein indirekter Anzeigetreiber (IDD) kann IddCxAdapterSetRenderAdapter jederzeit aufrufen, um den bevorzugten Renderadapter zu ändern. Der Treiber kann die Dxgi-Enumeration 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ückrufs.

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 erneut darauf zu erstellen. Benutzern können einige visuelle Störungen/Artefakte angezeigt werden, wenn das Betriebssystem die Desktopkomposition neu konfiguriert. Um Störungen zu vermeiden, sollte der Treiber iddCxAdapterSetRenderAdapter vor dem Hinzufügen von Monitoren aufrufen und nur ändern, wenn Pfade aktiv sind, wenn der Benutzer ihn explizit angefordert hat, z. B. über eine Begleitanwendung für Geräte.

IddCxAdapterSetRenderAdapter wird sowohl für Konsolen- als auch für Remote-ID-Adapter unterstützt.

Anforderungen

Weitere Informationen

IDARG_IN_ADAPTERSETRENDERADAPTER