DXGKDDI_SETTARGETADJUSTEDCOLORIMETRY Rückruffunktion (dispmprt.h)

Artikel
02/23/2024

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

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 videogegenstreichen Ziels einer Grafikkarte.

[in] AdjustedColorimetry

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

Rückgabewert

Der Treiber gibt STATUS_SUCCESS zurück, wenn er seine Farbmetrikwerte basierend auf den angegebenen Daten aktualisiert hat.

Wenn der Treiber ausfällt, rückgängig machen das Betriebssystem auf Standard-SDR-Werte für alle Parameter, 709 Vorwahlen, 2,2 Gamma und 8 Nit pro Farbkomponente RGB-Kabelformat, aber es ruft den Treiber nicht auf, da dies niemals fehlschlagen sollte. Stattdessen sollte der Treiber auch seine interne Darstellung des Anzeigegeräts aktualisieren, um standard SDR zu sein.

Hinweise

Da es sich bei aktuellen Anzeigegeräten um unvollständige und ungenaue Beschreibungen ihrer farbmetrischen Parameter handelt, sind Überschreibungen erforderlich. Die Außerkraftsetzungen haben 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. Um den Treiber mit den vom Betriebssystem verwendeten Parametern synchron zu halten, ruft das Betriebssystem DxgkDdiSetTargetAdjustedColorimetry für jedes Ziel auf.

In der Regel erfolgt dieser Aufruf nur einmal, 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 diese eintreffen, nachdem die Anzeige bereits aktiv ist. In diesem Fall aktualisiert das Betriebssystem weiterhin den Treiber, der alle erforderlichen Updates für die 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 auf Null gesetzt, 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 nach Möglichkeit ausgelagert werden sollte.

Anforderungen

Anforderung	Wert
Zielplattform	Windows
Kopfzeile	dispmprt.h

Freigeben über