IDXGISwapChain4：：SetHDRMetaData 方法 (dxgi1_5.h)
警告
不再建議應用程式使用 SetHDRMetaData 在其交換鏈結上明確設定 HDR 元數據。 Windows 不保證交換鏈結元數據會傳送至監視器，而且監視器不會一致地處理 HDR 元數據。 因此，建議應用程式一律將內容音調對應至監視器所報告的範圍。 如需如何撰寫以動態方式回應監視功能的應用程式詳細資訊，請參閱 搭配高動態範圍顯示器和進階色彩使用 DirectX。
如需詳細資訊，請參閱。
此方法會設定高動態範圍 (HDR) 和寬色彩遊戲 (WCG) 標頭元數據。
語法
HRESULT SetHDRMetaData(
[in] DXGI_HDR_METADATA_TYPE Type,
[in] UINT Size,
[in, optional] void *pMetaData
);
參數
[in] Type
指定 DXGI_HDR_METADATA_TYPE 列舉的一個成員。
[in] Size
類型： UINT
指定 pMetaData 的大小，以位元組為單位。
[in, optional] pMetaData
類型： void*
指定參考元數據的 void 指標，如果有的話。 請參閱 DXGI_HDR_METADATA_HDR10 結構。
傳回值
類型： HRESULT
這個方法會傳回 HRESULT 成功或錯誤碼。
備註
這個方法會設定元數據，讓監視器的輸出根據其功能進行調整。 不過，它不會變更 Windows 或監視器解譯圖元值的方式。 若要調整交換鏈結的色彩空間，請改用 SetColorSpace1 。
應用程式不應依賴傳送至監視器的元數據，因為可能會忽略元數據。 監視器不會一致地處理 HDR 元數據，導致不同監視器的內容外觀不同。 為了確保各種監視器、裝置和使用案例之間的輸出更一致，建議您不要使用 SetHDRMetaData ，而是改為將內容音調對應至監視器所支援的遊戲和亮度範圍。 請參閱 IDXGIOutput6：：GetDesc1 以擷取監視器支援的遊戲和亮度範圍。 遵守 VESA DisplayHDR 標準的監視器會自動針對監視器支援遊戲範圍外的內容執行裁剪形式。
如需如何撰寫以動態方式回應監視功能的應用程式詳細資訊，請參閱 搭配高動態範圍顯示器和進階色彩使用 DirectX。
規格需求
| 目標平台 | Windows |
| 標頭 | dxgi1_5.h |
| 程式庫 | Dxgi1_5.lib |
| Dll | Dxgi1_5.dll |