IDXGISwapChain4::SetHDRMetaData 메서드(dxgi1_5.h)

경고

앱이 SetHDRMetaData를 사용하여 스왑 체인에서 HDR 메타데이터를 명시적으로 설정하는 것은 더 이상 권장되지 않습니다. Windows는 스왑 체인 메타데이터가 모니터로 전송되고 모니터가 HDR 메타데이터를 일관되게 처리하지 않도록 보장하지 않습니다. 따라서 앱은 항상 모니터에서 보고하는 범위로 콘텐츠를 톤 맵하는 것이 좋습니다. 기능을 모니터링하기 위해 동적으로 반응하는 앱을 작성하는 방법에 대한 자세한 내용은 높은 동적 범위 디스플레이 및 고급 색으로 DirectX 사용을 참조하세요.

자세한 내용은 설명을 참조하세요.

이 메서드는 HDR(High Dynamic Range) 및 WCG(Wide Color Gamut) 헤더 메타데이터를 설정합니다.

구문

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
헤더	dxgi1_5.h
라이브러리	Dxgi1_5.lib
DLL	Dxgi1_5.dll

추가 정보

DXGI 1.5 Improvements(DXGI 1.5 개선 사항)

IDXGISwapChain4