Метод 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

Указывает один член перечисления 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

См. также раздел

Улучшения DXGI 1.5

IDXGISwapChain4