IddCxAdapterDisplayConfigUpdate2-Funktion (iddcx.h)

Ein Remotetreiber kann IddCxAdapterDisplayConfigUpdate2 aufrufen, damit ein Client dem Server mitteilen kann, wie die Monitorkonfiguration aktualisiert wird.

Syntax

HRESULT IddCxAdapterDisplayConfigUpdate2(
  IDDCX_ADAPTER                              AdapterObject,
  const IDARG_IN_ADAPTERDISPLAYCONFIGUPDATE2 *pInArgs
);

Parameter

AdapterObject

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

pInArgs

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

Rückgabewert

IddCxAdapterDisplayConfigUpdate2 gibt bei Erfolg STATUS_SUCCESS zurück. Andernfalls wird ein entsprechender Fehlercode zurückgegeben.

Hinweise

Ein indirekter Remoteanzeigetreiber kann IddCxAdapterDisplayConfigUpdate2 aufrufen, um den Modus, die Farbmetrik und andere Werte festzulegen, die das Betriebssystem für einen bestimmten Monitor verwenden sollte. Nur Remotetreiber können diese Funktion aufrufen.

Weitere Informationen zur HDR-Unterstützung finden Sie unter Updates für IddCx Version 1.10.

Die IDDCX_DISPLAYCONFIGPATH2 Struktur ist so definiert, dass nicht alle Informationen bei jedem Aufruf bereitgestellt werden müssen. Beispielsweise können einige Pfade keine Farbmetrikdaten bereitstellen, wenn der Farbmodus nicht HDR oder WCG ist, oder IddCxAdapterDisplayConfigUpdate2 kann aufgerufen werden, um die SDR-Weißebene nur zu aktualisieren, wenn keine Layoutänderungen erforderlich sind.

Die Steuerungsmodi (Festlegen des IDDCX_DISPLAYCONFIGPATH2_FLAGS_MODE_VALID-Flags für einen Pfad) umfasst einige zusätzliche Regeln und Klarstellungen:

• Wenn ein Pfad IDDCX_DISPLAYCONFIGPATH2_FLAGS_MODE_VALID festgelegt ist, muss er für alle bereitgestellten Pfade festgelegt sein.
• Wenn IDDCX_DISPLAYCONFIGPATH2_FLAGS_MODE_VALID für alle Pfade bereitgestellt wird, werden alle derzeit aktiven Pfade, die nicht in der Pfadliste enthalten sind, inaktiv.
• Wenn nur nicht IDDCX_DISPLAYCONFIGPATH2_FLAGS_MODE_VALID Flags festgelegt sind, müssen nur die zu aktualisierenden Pfade vorhanden sein.
• Abhängig vom angegebenen Farbmodus sind möglicherweise zusätzliche Daten für einen Pfad erforderlich. In der folgenden Tabelle ist angegeben, welche zusätzlichen Flags festgelegt werden müssen:

Erster im Vergleich zu nachfolgenden Aufrufen von IddCxAdapterDisplayConfigUpdate2

Wenn ein Pfad zum ersten Mal in einen IddCxAdapterDisplayConfigUpdate2-Aufruf aufgenommen wird, gelten andere Anforderungen als die nachfolgenden Zeiten. In der folgenden Tabelle werden die Anforderungen beschrieben.

Verhaltensunterschiede bei der Ausführung unter Windows 11, Version 22H2 September Update

Aufgrund der zugrunde liegenden Betriebssystemfunktionalität unterscheidet sich die Unterstützung für Treiber, die HDR- und WCG-Farbmodi anfordern, wenn sie unter Windows 11, Version 22H2 September Update, geringfügig von der Version 22H2 im September 2024 ausgeführt werden. Ein Treiber kann die IddCxGetVersion-Funktion verwenden, um zu bestimmen, unter welchem Betriebssystem er ausgeführt wird. In der folgenden Tabelle wird beschrieben, welche Farbmodi ein Treiber abhängig vom zuvor für das Betriebssystem bereitgestellten Monitordeskriptor anfordern kann:

Beispiele

Es folgen einige Beispiele dafür, welche Pfade in nachfolgende IddCxAdapterDisplayConfigUpdate2-Aufrufe eingeschlossen werden sollen. Zu Beginn jedes Szenarios werden für eine Remotesitzung die folgenden Pfade konfiguriert:

Szenario 1: Ändern der Desktopposition von Monitor 3 auf links von Monitor 1

Szenario 2: Ändern von Monitor 2 von SDRWCG zu SDR

Szenario 3: Ändern von Monitor 1 von SDR zu HDR

Szenario 4: Ändern des Skalierungsfaktors von Monitor 2

Szenario 5: Ändern des Skalierungsfaktors von Monitor 2 und der Desktopposition von Monitor 3, um von Monitor 1 zu bleiben

Szenario 6: Entfernen von Monitor 2 aus der aktuellen Konfiguration

Anforderungen

Weitere Informationen

IDARG_IN_ADAPTERDISPLAYCONFIGUPDATE2