Метод IDXGISwapChain4::SetHDRMetaData (dxgi1_5.h)
Предупреждение
Приложениям больше не рекомендуется явно задавать метаданные HDR в своей цепочке буферов с помощью SetHDRMetaData. 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 |
| Header | dxgi1_5.h |
| Библиотека | Dxgi1_5.lib |
| DLL | Dxgi1_5.dll |