IDXGISwapChain4::SetHDRMetaData-Methode (dxgi1_5.h)

  • Artikel

Warnung

Es wird nicht mehr empfohlen, dass Apps HDR-Metadaten in ihrer Swapchain explizit mithilfe von SetHDRMetaData festlegen. Windows garantiert nicht, dass Swapchainmetadaten an den Monitor gesendet werden, und Monitore verarbeiten HDR-Metadaten nicht konsistent. Daher wird empfohlen, Dass Apps Inhalte immer dem vom Monitor gemeldeten Bereich zuordnen. 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.

Weitere Informationen finden Sie unter Hinweise.

Diese Methode legt HIGH Dynamic Range (HDR) und WCG-Headermetadaten (Wide Color Gamut) fest.

Syntax

HRESULT SetHDRMetaData(
  [in]           DXGI_HDR_METADATA_TYPE Type,
  [in]           UINT                   Size,
  [in, optional] void                   *pMetaData
);

Parameter

[in] Type

Typ: DXGI_HDR_METADATA_TYPE

Gibt ein Element der DXGI_HDR_METADATA_TYPE Enumeration an.

[in] Size

Typ: UINT

Gibt die Größe von pMetaData in Bytes an.

[in, optional] pMetaData

Typ: void*

Gibt einen void-Zeiger an, der auf die Metadaten verweist, sofern vorhanden. Weitere Informationen finden Sie in der DXGI_HDR_METADATA_HDR10-Struktur .

Rückgabewert

Typ: HRESULT

Diese Methode gibt einen HRESULT-Erfolgs- oder Fehlercode zurück.

Hinweise

Diese Methode legt Metadaten fest, damit die Ausgabe eines Monitors abhängig von seinen Funktionen angepasst werden kann. Es ändert sich jedoch nicht, wie Pixelwerte von Windows oder Monitoren interpretiert werden. Verwenden Sie stattdessen SetColorSpace1 , um den Farbraum der Swapchain anzupassen.

Anwendungen sollten sich nicht auf die Metadaten verlassen, die an den Monitor gesendet werden, da die Metadaten möglicherweise ignoriert werden. Monitore verarbeiten HDR-Metadaten nicht konsistent, was zu einer unterschiedlichen Darstellung Ihrer Inhalte auf verschiedenen Monitoren führt. Um eine konsistentere Ausgabe für eine Reihe von Monitoren, Geräten und Anwendungsfällen zu gewährleisten, wird empfohlen, SetHDRMetaData nicht zu verwenden und stattdessen Inhalte in den vom Monitor unterstützten Gamut- und Leuchtdichtebereich zuzuordnen. Unter IDXGIOutput6::GetDesc1 können Sie den unterstützten Gamut- und Leuchtdichtebereich des Monitors abrufen. Monitore, die dem VESA DisplayHDR-Standard entsprechen, führen automatisch eine Form der Beschneidung für Inhalte außerhalb des unterstützten Gamut- und Luminanzbereichs des Monitors durch.

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.

Anforderungen

   
Zielplattform Windows
Kopfzeile dxgi1_5.h
Bibliothek Dxgi1_5.lib
DLL Dxgi1_5.dll

Weitere Informationen

DXGI 1.5-Verbesserungen

IDXGISwapChain4