Método IDXGISwapChain4::SetHDRMetaData (dxgi1_5.h)
Aviso
Não é mais recomendável que os aplicativos definam explicitamente os metadados do HDR em sua cadeia de troca usando SetHDRMetaData. O Windows não garante que os metadados de cadeia de troca sejam enviados para o monitor e os monitores não lidam com metadados hdr de forma consistente. Portanto, é recomendável que os aplicativos sempre mapeiem conteúdo para o intervalo relatado pelo monitor. Para obter mais detalhes sobre como escrever aplicativos que reagem dinamicamente para monitorar recursos, consulte Usando o DirectX com exibições de alto intervalo dinâmico e Cor Avançada.
Consulte Comentários para obter mais detalhes.
Esse método define metadados de cabeçalho HDR (High Dynamic Range) e WCG (Wide Color Gamut).
Sintaxe
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 um membro da enumeração DXGI_HDR_METADATA_TYPE .
[in] Size
Tipo: UINT
Especifica o tamanho de pMetaData, em bytes.
[in, optional] pMetaData
Tipo: void*
Especifica um ponteiro nulo que faz referência aos metadados, se existirem. Consulte a estrutura de DXGI_HDR_METADATA_HDR10 .
Retornar valor
Tipo: HRESULT
Esse método retorna um código de erro ou êxito HRESULT.
Comentários
Esse método define metadados para permitir que a saída de um monitor seja ajustada dependendo de seus recursos. No entanto, ele não altera como os valores de pixel são interpretados pelo Windows ou monitores. Para ajustar o espaço de cor da cadeia de troca, use SetColorSpace1 .
Os aplicativos não devem depender dos metadados que estão sendo enviados para o monitor, pois os metadados podem ser ignorados. Os monitores não processam metadados hdr consistentemente, resultando em uma aparência variada do seu conteúdo em diferentes monitores. Para garantir uma saída mais consistente em uma variedade de monitores, dispositivos e casos de uso, é recomendável não usar SetHDRMetaData e, em vez disso, mapear o conteúdo para o intervalo de gama e luminância com suporte do monitor. Consulte IDXGIOutput6::GetDesc1 para recuperar o intervalo de gama e luminância com suporte do monitor. Os monitores que aderirem ao padrão VESA DisplayHDR executarão automaticamente uma forma de recorte para conteúdo fora do intervalo de gama e luminância com suporte do monitor.
Para obter mais detalhes sobre como escrever aplicativos que reagem dinamicamente para monitorar recursos, consulte Usando o DirectX com exibições de alto intervalo dinâmico e Cor Avançada.
Requisitos
| Plataforma de Destino | Windows |
| Cabeçalho | dxgi1_5.h |
| Biblioteca | Dxgi1_5.lib |
| DLL | Dxgi1_5.dll |