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

Confira também

Melhorias do DXGI 1.5

IDXGISwapChain4