DXGK_QUERYINTEGRATEDDISPLAYOUT2-Struktur (d3dkmddi.h)

  • Artikel

Wird während einer Abfrage für die integrierte Anzeigeausgabe verwendet.

Syntax

typedef struct _DXGK_QUERYINTEGRATEDDISPLAYOUT2 {
  [out] DXGK_INTEGRATEDDISPLAYFLAGS        Flags;
  [out] D3DKMDT_VIDEO_SIGNAL_INFO          NativeTiming;
  [out] DXGK_MONITORLINKINFO_CAPABILITIES  LinkCapabilities;
  [out] DXGK_COLORIMETRY                   Colorimetry;
  [out] DXGK_DISPLAY_TECHNOLOGY            DisplayTechnology;
  [out] DXGK_DISPLAY_USAGE                 IntendedUsage;
  [out] BYTE                               Instance;
  [out] DXGK_DISPLAY_DESCRIPTOR_TYPE       DescriptorType;
  [out] D3DKMDT_WIRE_FORMAT_AND_PREFERENCE DitheringSupport;
} DXGK_QUERYINTEGRATEDDISPLAYOUT2, *PDXGK_QUERYINTEGRATEDDISPLAYOUT2;

Member

[out] Flags

Zeiger auf eine DXGK_INTEGRATEDDISPLAYFLAGS Struktur, die einfache Eigenschaften einer integrierten Anzeige beschreibt. Ausrichtungswerte von 0 Grad geben an, dass der Deskriptor nicht außer Kraft gesetzt wird.

[out] NativeTiming

Zeiger auf eine [D3DKMDT_VIDEO_SIGNAL_INFO]/d3dkmdt/ns-d3dkmdt-_d3dkmdt_video_signal_info.md)-Struktur, die Informationen zu einem nativen Timing der integrierten Anzeige enthält. Sollte null gesetzt werden, um anzugeben, dass keine Außerkraftsetzung erfolgt. Dieser Wert überschreibt das systemeigene Timing im Deskriptor. Da der Treiber für die Bereitstellung des Deskriptors verantwortlich ist, besteht die einzige erwartete Verwendung dieser Außerkraftsetzung darin, ein Timing zu beschreiben, das nicht durch eine EDID beschrieben werden kann, ganz offensichtlich eine Anzeige, die mehr als 4095 adressierbare Pixel in beide Richtungen aufweist. Wenn eine NativeTiming-Außerkraftsetzung bereitgestellt wird, ruft das Betriebssystem dxgkDdiRecommendMonitorModes für dieses Ziel nicht auf. Im Allgemeinen unterstützen integrierte Panels keinen großen Satz von Timings, und der Treiber sollte gut auf die bereitgestellte EDID abgestimmt sein. Wenn der Treiber mehrere Außerkraftsetzungen für Überwachungsmodi beschreiben muss, sollte er die NativeTiming-Struktur null lassen und alle Außerkraftsetzungen mithilfe von DxgkDdiRecommendMonitorModes melden.

[out] LinkCapabilities

Zeiger auf eine DXGK_MONITORLINKINFO_CAPABILITIES-Struktur , die die Linkfunktionen zum Steuern des Monitors beschreibt. Dies sind die gleichen Linkfunktionen, die das Betriebssystem nach dem Hot-Plug von einer externen Anzeige abfragen würde. Da eine integrierte Anzeige während der Adaptertreiberinitialisierung verfügbar gemacht wird, werden die Funktionen direkt beschrieben, anstatt einen zusätzlichen DDI-Aufruf durchzuführen.

Ab WDDM 2.6 wird dieses Element verwendet, um die Unterstützung der Synchronisierung zu melden.

[out] Colorimetry

Farbmetrik-bezogene Überschreibungen für die Anzeige. Die Felddefinitionen und Einschränkungen für die Kombinationen von Feldern finden Sie in der Beschreibung der DXGK_COLORIMETRY .

[out] DisplayTechnology

Wert, der die Technologie der Anzeige darstellt. Wird verwendet, um die Benutzererfahrung zu optimieren, z. B. die Aktivierung eines dunkleren Designs mit reduziertem blauem Inhalt auf DXGK_DT_OLED Displays.

[out] IntendedUsage

Wert, der die beabsichtigte Verwendung der Anzeige durch den Hersteller angibt. Der gemeldete Wert sollte DXGK_DU_GENERIC sein, es sei denn, der Treiber verfügt über Informationen, die auf eine spezifischere Verwendung hinweisen. Wenn das integrierte Display für ar-, VR- oder Hilfsausgaben verwendet werden soll, muss der Treiber über genügend spezifische Handhabung verfügen, um die richtige Verwendung zu melden.

[out] Instance

Eine nullbasierte ganze Zahl für die instance des integrierten Bereichs. Wird verwendet, um mehrere integrierte Panels zu bestellen. Werte müssen über integrierte Ziele hinweg eindeutig und zusammenhängend sein, müssen aber nicht in der Reihenfolge gemeldet werden.

[out] DescriptorType

Wert, der den Typ des Deskriptors angibt. Für WDDM 2.4 muss dieser Wert DXGK_DDT_EDID sein. Ab WDDM 2.5 und höher ist entweder DXGK_DDT_EDID oder DXGK_DDT_DISPLAYID zulässig.

[out] DitheringSupport

Ein D3DKMDT_WIRE_FORMAT_AND_PREFERENCE Feld, das die Flags für jedes Drahtformat enthält. Der Treiber sollte das Wire-Format-Bit für jedes Format festlegen, bei dem treiber und Hardware dithering von Vorteil für die Bildqualität unterstützen, wenn das Quellpixelformat eine höhere Genauigkeit als das Wire-Format enthält.

Hinweise

Die Felder enthalten Überschreibungsattribute der Anzeige, die von einem Deskriptor bereitgestellt werden können, aber entweder nicht durch eine EDID beschrieben werden können oder häufig fehlende oder falsche EDIDs aufweisen. Wenn ein Konflikt zwischen dem Deskriptor und diesen Außerkraftsetzungsfeldern besteht, verwendet das Betriebssystem die Außerkraftsetzungen, wenn sie gültig sind.

Das Betriebssystem überprüft die Felder und schlägt fehl, wenn Felder inkonsistent oder ungültig sind. Für die meisten Felder bedeutet die Integritätsprüfung einfach, dass die gemeldeten Werte im Bereich liegen, aber für die Felder Colorimetry, Instanz und Deskriptor wurde eine weitere Validierung angewendet. Informationen zu Colorimetry finden Sie in der Beschreibung der DXGK_COLORIMETRY für die Validierung. Instanzwerte werden auf allen integrierten Displays als konsistent überprüft, wie oben erwähnt. Der Deskriptor muss eine gültige EDID sein.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 10, Version 1803
Kopfzeile d3dkmddi.h