IDXGIOutput6::GetDesc1-Methode (dxgi1_6.h)

Rufen Sie eine erweiterte Beschreibung der Ausgabe ab, die Farbmerkmale und Verbindungstyp enthält.

Syntax

HRESULT GetDesc1(
  [out] DXGI_OUTPUT_DESC1 *pDesc
);

Parameter

[out] pDesc

Typ: DXGI_OUTPUT_DESC1*

Ein Zeiger auf die Ausgabebeschreibung (siehe DXGI_OUTPUT_DESC1).

Rückgabewert

Typ: HRESULT

Gibt einen Code zurück, der Erfolg oder Fehler angibt. S_OK bei erfolgreicher Ausführung DXGI_ERROR_INVALID_CALL , wenn pDesc als NULL übergeben wird.

Hinweise

Einige Szenarien verfügen nicht über klar definierte Werte für alle Felder in dieser Struktur. Beispielsweise, wenn dieser IDXGIOutput einen Klon-/Duplikatsatz darstellt oder wenn die EDID fehlende oder ungültige Daten enthält. In diesen Fällen stellt das Betriebssystem einige Standardwerte bereit, die einer Standard-SDR-Anzeige entsprechen.

Die gemeldeten Farb- und Leuchtdichteeigenschaften einer Ausgabe können sich dynamisch anpassen, während das System ausgeführt wird, aufgrund von Benutzeraktionen oder sich ändernden Umgebungsbedingungen. Daher sollten Apps in regelmäßigen Abständen IDXGIFactory::IsCurrent abfragen und ihre IDXGIFactory neu erstellen, wenn FALSE zurückgegeben wird. Fragen Sie getDesc1 dann erneut aus der entsprechenden Ausgabe der neuen Factory ab, um die neuesten Farbinformationen abzurufen.

Weitere Informationen zum Schreiben von Apps, die dynamisch auf Überwachungsfunktionen reagieren, finden Sie unter Verwenden von DirectX mit Anzeigen mit hohem Dynamischen Bereich und erweiterter Farbe.

Auf einem Desktop mit hohem DPI-Wert gibt GetDesc1 die visualisierte Bildschirmgröße zurück, es sei denn, die App ist als hohe DPI-fähig gekennzeichnet. Informationen zum Schreiben von DPI-fähigen Win32-Apps finden Sie unter Hoher DPI-Wert.

Anforderungen

Zielplattform	Windows
Kopfzeile	dxgi1_6.h
Bibliothek	DXGI.lib

Weitere Informationen

DXGI-Schnittstellen

IDXGIOutput6