IDXGISwapChain4::SetHDRMetaData メソッド (dxgi1_5.h)

  • [アーティクル]

警告

SetHDRMetaData を使用してスワップ チェーンで HDR メタデータを明示的に設定することは、アプリでは推奨されなくなりました。 Windows では、スワップ チェーン メタデータがモニターに送信される保証はありません。また、モニターは HDR メタデータを一貫して処理しません。 そのため、アプリは常にモニターによって報告された範囲にコンテンツをトーンマップすることをお勧めします。 動的に対応して機能を監視するアプリを作成する方法の詳細については、「 高ダイナミック レンジ ディスプレイと高度な色での DirectX の使用」を参照してください。

詳細については、「解説」を参照してください。

このメソッドは、ハイ ダイナミック レンジ (HDR) とワイド カラー ガマット (WCG) ヘッダー のメタデータを設定します。

構文

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列挙型の 1 つのメンバー を 指定します。

[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
Library Dxgi1_5.lib
[DLL] Dxgi1_5.dll

こちらもご覧ください

DXGI 1.5 の機能強化

IDXGISwapChain4