IddCxAdapterDisplayConfigUpdate-Funktion (iddcx.h)

  • Artikel

Ein Remotetreiber kann IddCxAdapterDisplayConfigUpdate aufrufen, damit ein Client dem Server mitteilen kann, wie die Monitorkonfiguration aktualisiert werden soll. Ein Treiber, der HDR-Unterstützung meldet, muss stattdessen IddCxAdapterDisplayConfigUpdate2 verwenden.

Syntax

NTSTATUS IddCxAdapterDisplayConfigUpdate(
  IDDCX_ADAPTER                             AdapterObject,
  const IDARG_IN_ADAPTERDISPLAYCONFIGUPDATE *pInArgs
);

Parameter

AdapterObject

[in] Das IDDCX_ADAPTER Objekt des Remoteadapters, für den die Anzeigekonfiguration angegeben ist.

pInArgs

[in] Zeiger auf eine IDARG_IN_ADAPTERDISPLAYCONFIGUPDATE Struktur, die Eingabeargumente für die Funktion enthält.

Rückgabewert

IddCxAdapterDisplayConfigUpdate gibt bei Erfolg STATUS_SUCCESS zurück. Andernfalls wird ein entsprechender Fehlercode zurückgegeben. Siehe Hinweise.

Hinweise

Ein Remote-Indirekter Anzeigetreiber (Remote Indirect Display Driver, IDD) ruft IddCxAdapterDisplayConfigUpdate auf, wenn er eine neue Anzeigekonfiguration empfängt.

Das Betriebssystem gibt STATUS_SUCCESS zurück, wenn die neu angegebene Anzeigekonfiguration gespeichert wurde. Mit diesen Änderungen werden die Swapchains für die Monitore wie angefordert asynchron neu konfiguriert. IddCxAdapterDisplayConfigUpdate löscht zunächst alle ausstehenden Monitorankünfte und verarbeitet Abfahrten, um sicherzustellen, dass die Liste der Monitore aktuell ist.

Wenn IddCxAdapterDisplayConfigUpdate feststellt, dass die angegebene Anzeigekonfiguration derzeit nicht vom Treiber unterstützt wird, wird STATUS_INVALID_PARAMETER zurückgegeben und der Grund für die Verwendung von WPP zu Debugzwecken protokolliert. Beispielsweise unterstützt ein Treiber möglicherweise keine angegebene Auflösungs-/Aktualisierungsrate, oder es wird ein ungültiger Monitor angegeben.

IddCxAdapterDisplayConfigUpdate gibt STATUS_GRAPHICS_INDIRECT_DISPLAY_DEVICE_STOPPED zurück, wenn die Sitzung, auf die diese Konfigurationsänderung abzielt, getrennt wird oder wenn der Sitzungsadapter beendet wird.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 10, Version 1903
Kopfzeile iddcx.h

Weitere Informationen

IDARG_IN_ADAPTERDISPLAYCONFIGUPDATE

IddCxAdapterDisplayConfigUpdate2