Freigeben über


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] Zeigen Sie auf eine IDARG_IN_ADAPTERDISPLAYCONFIGUPDATE2 Struktur, die Eingabeargumente für die Funktion enthält.

Rückgabewert

IddCxAdapterDisplayConfigUpdate2 gibt nach Erfolg STATUS_SUCCESS zurück; andernfalls wird ein entsprechender Fehlercode zurückgegeben.

Bemerkungen

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

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

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

Das Steuern von Modi (Festlegen des IDDCX_DISPLAYCONFIGPATH2_FLAGS_MODE_VALID-Flags für einen Pfad) weist einige zusätzliche Regeln und Klarstellungen auf:

  • Wenn ein Pfad IDDCX_DISPLAYCONFIGPATH2_FLAGS_MODE_VALID festgelegt hat, müssen alle bereitgestellten Pfade festgelegt sein.
  • Wenn IDDCX_DISPLAYCONFIGPATH2_FLAGS_MODE_VALID auf allen Pfaden bereitgestellt wird, werden alle derzeit aktiven Pfade, die sich nicht in der Pfadliste befinden, inaktiv.
  • Wenn nur nicht-IDDCX_DISPLAYCONFIGPATH2_FLAGS_MODE_VALID Flags festgelegt werden, müssen nur die zu aktualisierenden Pfade vorhanden sein.
  • Je nach angegebenem Farbmodus sind möglicherweise zusätzliche Daten für einen Pfad erforderlich. In der folgenden Tabelle wird angegeben, welche zusätzlichen Flags festgelegt werden müssen:
Farbmodus IDDCX_DISPLAYCONFIGPATH2_FLAGS_MONITOR_COLORIMETRY_VALID IDDCX_DISPLAYCONFIGPATH2_FLAGS_MONITOR_SDRWHITELEVEL_VALID
SZR Nein Nein
SDRWCG Ja Nein
HDR Ja Ja

First versus subsequent calls to IddCxAdapterDisplayConfigUpdate2

Wenn ein Pfad zum ersten Mal in einem IddCxAdapterDisplayConfigUpdate2 Aufruf enthalten ist, weist andere Anforderungen als nachfolgende Zeiten auf. In der folgenden Tabelle sind die Anforderungen beschrieben.

Pfadfeld Erforderlich im anfänglichen Aufruf für den Pfad Kann nach dem anfänglichen Anruf aktualisiert werden So erhalten Windows-Client die Informationen
Modus Ja Ja QueryDisplayConfig- stellt clientseitige Anzeigekonfiguration bereit und WM_DISPLAYCHANGE wird gesendet, wenn sich die Konfigurationsänderungen ändern; AdvancedColorInfo.CurrentAdvancedColorKind einen Farbmodus verleihen
Einteilungsfaktor Ja Ja Treiber können die methode verwenden, die für IddCxAdapterDisplayConfigUpdate
Physische Größe Ja, wenn keine EDID übergeben wurde Nein Nicht erforderlich, wenn EDID übergeben wurde
Farbmetrik Ja für nicht-SDR-Farbmodus Ja Die meisten Felder aus entsprechenden AdvancedColorInfo- Feldern
SDR-Weißebene Ja für den HDR-Farbmodus, Der Standardwert ist 80 nissen Ja AdvancedColorInfo.SdrWhiteLevelInNitsfinden Sie unter DirectX mit erweiterter Farbe auf HDR/SDR-Displays

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 ausgeführt werden, geringfügig von der Ausführung auf der Windows-Plattformversion ab 2024. Ein Treiber kann die IddCxGetVersion--Funktion verwenden, um zu bestimmen, auf welchem Betriebssystem sie ausgeführt werden. In der folgenden Tabelle wird beschrieben, welche Farbmodi ein Treiber je nach dem Monitordeskriptor anfordern kann, der zuvor für das Betriebssystem bereitgestellt wurde:

Edid-Typ 22H2 September Update mögliche Farbmodi Plattformversion in 2024 möglichen Farbmodi
Nichts SDR, HDR SDR, SDRWCG, HDR
SZR SDR, SDRWCG SDR, SDRWCG
HDR SDR, HDR SDR, SDRWCG, HDR

Beispiele

Einige Beispiele dafür, welche Pfade in nachfolgende IddCxAdapterDisplayConfigUpdate2 Aufrufen folgen. Zu Beginn jedes Szenarios hat eine Remotesitzung die folgenden Pfade konfiguriert:

Monitor Auflösung Desktopposition Farbmodus
1 1920x1080 @ 30Hz 0,0 SZR
2 1024x768 @ 30Hz 1024,0 SDRWCG
3 3840x2160 @ 30Hz 0,1848 HDR

Szenario 1 – Ändern der Desktopposition von Monitor 3 auf "Monitor 1"

Monitor Flaggen Details
1 IDDCX_DISPLAYCONFIGPATH2_FLAGS_MODE_VALID Keine Änderung an aktuellen Modusdaten
2 IDDCX_DISPLAYCONFIGPATH2_FLAGS_MODE_VALID Keine Änderung an aktuellen Modusdaten
3 IDDCX_DISPLAYCONFIGPATH2_FLAGS_MODE_VALID Ändern der Desktopposition in -3840,0

Szenario 2 – Änderungsmonitor 2 von SDRWCG zu SDR

Monitor Flaggen Details
1 IDDCX_DISPLAYCONFIGPATH2_FLAGS_MODE_VALID Keine Änderung an aktuellen Modusdaten
2 IDDCX_DISPLAYCONFIGPATH2_FLAGS_MODE_VALID Neuen Farbmodus festlegen
3 IDDCX_DISPLAYCONFIGPATH2_FLAGS_MODE_VALID Keine Änderung an aktuellen Modusdaten

Szenario 3 – Ändern des Monitors 1 von SDR zu HDR

Monitor Flaggen Details
1 IDDCX_DISPLAYCONFIGPATH2_FLAGS_MODE_VALID, IDDCX_DISPLAYCONFIGPATH2_FLAGS_MONITOR_COLORIMETRY_VALID, IDDCX_DISPLAYCONFIGPATH2_FLAGS_MONITOR_SDRWHITELEVEL_VALID Festlegen des neuen Farbmodus, der Farbmetrie und der SDR-Weißebene
2 IDDCX_DISPLAYCONFIGPATH2_FLAGS_MODE_VALID Keine Änderung an aktuellen Modusdaten
3 IDDCX_DISPLAYCONFIGPATH2_FLAGS_MODE_VALID Keine Änderung an aktuellen Modusdaten

Szenario 4 – Skalierungsfaktor von Monitor 2

Monitor Flaggen Details
2 IDDCX_DISPLAYCONFIGPATH2_FLAGS_MONITOR_SCALE_FACTOR_VALID Neuen Skalierungsfaktor festlegen

Szenario 5 – Ändern des Skalierungsfaktors von Monitor 2 und der Desktopposition von Monitor 3 links von Monitor 1

Monitor Flaggen Details
1 IDDCX_DISPLAYCONFIGPATH2_FLAGS_MODE_VALID Keine Änderung an aktuellen Modusdaten
2 IDDCX_DISPLAYCONFIGPATH2_FLAGS_MODE_VALID, IDDCX_DISPLAYCONFIGPATH2_FLAGS_MONITOR_SCALE_FACTOR_VALID Keine Änderung an aktuellen Modusdaten, neue Skalierungsfaktor festlegen
3 IDDCX_DISPLAYCONFIGPATH2_FLAGS_MODE_VALID Ändern der Desktopposition in -3840,0

Szenario 6 – Entfernen von Monitor 2 aus der aktuellen Konfiguration

Monitor Flaggen Details
1 IDDCX_DISPLAYCONFIGPATH2_FLAGS_MODE_VALID Keine Änderung an aktuellen Modusdaten
3 IDDCX_DISPLAYCONFIGPATH2_FLAGS_MODE_VALID Keine Änderung an aktuellen Modusdaten

Anforderungen

Anforderung Wert
mindestens unterstützte Client- Windows 11, Version 22H2 September Update (IddCx, Version 1.10)
Header- iddcx.h

Siehe auch

IDARG_IN_ADAPTERDISPLAYCONFIGUPDATE2