METODE IDXGISwapChain4::SetHDRMetaData (dxgi1_5.h)
Peringatan
Tidak lagi disarankan bagi aplikasi untuk secara eksplisit mengatur metadata HDR pada rantai pertukaran mereka menggunakan SetHDRMetaData. Windows tidak menjamin bahwa metadata rantai pertukaran dikirim ke monitor, dan monitor tidak menangani metadata HDR secara konsisten. Oleh karena itu disarankan agar aplikasi selalu mengubah konten peta ke dalam rentang yang dilaporkan oleh monitor. Untuk detail selengkapnya tentang cara menulis aplikasi yang bereaksi dinamis terhadap kemampuan pemantauan, lihat Menggunakan DirectX dengan tampilan rentang dinamis tinggi dan Warna Tingkat Lanjut.
Lihat Keterangan untuk detail selengkapnya.
Metode ini menetapkan metadata header High Dynamic Range (HDR) dan Wide Color Gamut (WCG).
Sintaks
HRESULT SetHDRMetaData(
[in] DXGI_HDR_METADATA_TYPE Type,
[in] UINT Size,
[in, optional] void *pMetaData
);
Parameter
[in] Type
Jenis: DXGI_HDR_METADATA_TYPE
Menentukan satu anggota enum DXGI_HDR_METADATA_TYPE .
[in] Size
Jenis: UINT
Menentukan ukuran pMetaData, dalam byte.
[in, optional] pMetaData
Jenis: void*
Menentukan penunjuk kekosongan yang mereferensikan metadata, jika ada. Lihat struktur DXGI_HDR_METADATA_HDR10 .
Menampilkan nilai
Jenis: HRESULT
Metode ini mengembalikan kode keberhasilan atau kesalahan HRESULT.
Keterangan
Metode ini menetapkan metadata untuk memungkinkan output monitor disesuaikan tergantung pada kemampuannya. Namun tidak mengubah bagaimana nilai piksel ditafsirkan oleh Windows atau monitor. Untuk menyesuaikan ruang warna rantai pertukaran, gunakan SetColorSpace1 sebagai gantinya.
Aplikasi tidak boleh mengandalkan metadata yang dikirim ke monitor karena metadata dapat diabaikan. Monitor tidak secara konsisten memproses metadata HDR, menghasilkan tampilan konten yang bervariasi di berbagai monitor. Untuk memastikan output yang lebih konsisten di berbagai monitor, perangkat, dan kasus penggunaan, disarankan untuk tidak menggunakan SetHDRMetaData dan sebagai gantinya konten tone-map ke dalam rentang gamut dan luminance yang didukung oleh monitor. Lihat IDXGIOutput6::GetDesc1 untuk mengambil rentang gamut dan luminance monitor yang didukung. Monitor yang mematuhi standar VESA DisplayHDR akan secara otomatis melakukan bentuk kliping untuk konten di luar rentang gamut dan luminance monitor yang didukung.
Untuk detail selengkapnya tentang cara menulis aplikasi yang bereaksi dinamis terhadap kemampuan pemantauan, lihat Menggunakan DirectX dengan tampilan rentang dinamis tinggi dan Warna Tingkat Lanjut.
Persyaratan
| Target Platform | Windows |
| Header | dxgi1_5.h |
| Pustaka | Dxgi1_5.lib |
| DLL | Dxgi1_5.dll |