IDXGISwapChain4::SetHDRMetaData-Methode (dxgi1_5.h)
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
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 |