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 |