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 |