DXGKDDI_SETTARGETADJUSTEDCOLORIMETRY Rückruffunktion (dispmprt.h)

Artikel
02/06/2025

Meldet die vom Betriebssystem für ein Ziel ausgewählten Farbmetriewerte.

Syntax

DXGKDDI_SETTARGETADJUSTEDCOLORIMETRY DxgkddiSettargetadjustedcolorimetry;

NTSTATUS DxgkddiSettargetadjustedcolorimetry(
  [in] IN_CONST_HANDLE hAdapter,
  [in] IN D3DDDI_VIDEO_PRESENT_TARGET_ID TargetId,
  [in] IN DXGK_COLORIMETRY AdjustedColorimetry
)
{...}

Parameter

[in] hAdapter

[in] Identifiziert den Adapter.

[in] TargetId

[in] Der Bezeichner des Videoziels eines Grafikkarten.

[in] AdjustedColorimetry

[in] Eine DXGK_COLORIMETRY Struktur, die die zugehörigen Farbfelder für den Monitor enthält, der an dieses Ziel angefügt ist, nachdem das Betriebssystem den Anzeigegerätedeskriptor verarbeitet hat, alle Außerkraftsetzungen und alle Anpassungen.

Rückgabewert

Der Treiber gibt STATUS_SUCCESS zurück, wenn er seine Farbmetriewerte basierend auf den bereitgestellten Daten aktualisiert.

Wenn der Treiber fehlschlägt, wird das Betriebssystem auf standard-SDR-Werte für alle Parameter zurückgesetzt, 709 Primaries, 2,2 Gamma und 8-Nit pro Rgb-Komponenten-RGB-Drahtformat, aber er ruft den Treiber nicht auf, da dies niemals fehlschlagen sollte. Stattdessen sollte der Treiber auch seine interne Darstellung des Anzeigegeräts als Standard-SDR aktualisieren.

Bemerkungen

Da aktuelle Anzeigegeräte unvollständige und ungenaue Beschreibungen ihrer farbbezogenen Parameter aufweisen, sind Außerkraftsetzungen erforderlich. Die Außerkraftsetzungen bilden zwei Formen: Treiberüberschreibungen und Betriebssystemüberschreibungen für ungültige Parameter. In zukünftigen Betriebssystemversionen wird erwartet, dass zusätzliche Außerkraftsetzungen implementiert werden. Damit der Treiber mit den vom Betriebssystem verwendeten Parametern synchronisiert wird, ruft das Betriebssystem dxgkDdiSetTargetAdjustedColorimetry für jedes Ziel auf.

In der Regel wird dieser Aufruf nur einmal ausgeführt, nachdem der Treiber nach Außerkraftsetzungen abgefragt wurde und die Betriebssystemüberprüfung abgeschlossen wurde, aber bevor die Anzeige aktiviert wird. Wenn das Betriebssystem über andere Formen von Außerkraftsetzungen verfügt, ist es möglich, dass sie eingetroffen werden, nachdem die Anzeige bereits aktiv ist. In diesem Fall aktualisiert das Betriebssystem weiterhin den Treiber, der alle erforderlichen Updates für seine Anzeigepipeline innerhalb von zwei Frames vornehmen soll. Bei Bedarf sollte der Treiber die Anzeigeausgabe glimmern, um die Änderung anzuwenden.

Die FormatBitDepths und StandardColorimetryFlags in der DXGK_COLORIMETRY werden nulliert, da es sich hierbei um Funktionsfelder handelt, die nur in Abfragen gültig sind.

Diese Funktion wird immer auf PASSIVEr Ebene aufgerufen, sodass der unterstützende Code möglichst seitenfähig gemacht werden sollte.

Anforderungen

Anforderung	Wert
Zielplattform-	Fenster
Header-	dispmprt.h

Freigeben über