Método IDXGISwapChain4::SetHDRMetaData (dxgi1_5.h)

Advertencia

Ya no se recomienda que las aplicaciones establezcan explícitamente metadatos HDR en su cadena de intercambio mediante SetHDRMetaData. Windows no garantiza que los metadatos de la cadena de intercambio se envíen al monitor y los monitores no controlan los metadatos HDR de forma coherente. Por lo tanto, se recomienda que las aplicaciones siempre asignen contenido de mapa de tono en el intervalo notificado por el monitor. Para obtener más información sobre cómo escribir aplicaciones que reaccionan dinámicamente a las funcionalidades de supervisión, consulta Uso de DirectX con pantallas de alto rango dinámico y Color avanzado.

Consulte Comentarios para obtener más detalles.

Este método establece metadatos de encabezado high Dynamic Range (HDR) y Wide Color Gamut (WCG).

Sintaxis

HRESULT SetHDRMetaData(
  [in]           DXGI_HDR_METADATA_TYPE Type,
  [in]           UINT                   Size,
  [in, optional] void                   *pMetaData
);

Parámetros

[in] Type

Tipo: DXGI_HDR_METADATA_TYPE

Especifica un miembro de la enumeración DXGI_HDR_METADATA_TYPE .

[in] Size

Tipo: UINT

Especifica el tamaño de pMetaData, en bytes.

[in, optional] pMetaData

Tipo: void*

Especifica un puntero void que hace referencia a los metadatos, si existe. Consulte la estructura DXGI_HDR_METADATA_HDR10 .

Valor devuelto

Tipo: HRESULT

Este método devuelve un código de error o correcto HRESULT.

Comentarios

Este método establece los metadatos para permitir que la salida de un monitor se ajuste en función de sus funcionalidades. Sin embargo, no cambia el modo en que Windows o los monitores interpretan los valores de píxeles. Para ajustar el espacio de colores de la cadena de intercambio, use SetColorSpace1 en su lugar.

Las aplicaciones no deben depender de los metadatos que se envían al monitor, ya que los metadatos se pueden omitir. Los monitores no procesan de forma coherente los metadatos HDR, lo que da lugar a una apariencia variada del contenido en diferentes monitores. Para garantizar una salida más coherente en una variedad de monitores, dispositivos y casos de uso, se recomienda no usar SetHDRMetaData y, en su lugar, asignar el contenido de mapa de tono en el rango de gama y luminancia admitido por el monitor. Consulte IDXGIOutput6::GetDesc1 para recuperar la gama y la luminancia admitidas del monitor. Los monitores que se adhieren al estándar VESA DisplayHDR realizarán automáticamente una forma de recorte de contenido fuera de la gama de mutación y luminancia admitidas del monitor.

Para obtener más información sobre cómo escribir aplicaciones que reaccionan dinámicamente a las funcionalidades de supervisión, consulta Uso de DirectX con pantallas de alto rango dinámico y Color avanzado.

Requisitos

Plataforma de destino	Windows
Encabezado	dxgi1_5.h
Library	Dxgi1_5.lib
Archivo DLL	Dxgi1_5.dll

Consulte también

Mejoras de DXGI 1.5

IDXGISwapChain4