IDDCX_METADATA2構造体 (iddcx.h)

IDDCX_METADATA2 は、現在提供されているサーフェスとその画面に表示される内容に関する情報を提供します。

構文

struct IDDCX_METADATA2 {
  UINT                        Size;
  IDDCX_METADATA2_VALID_FLAGS ValidFlags;
  UINT                        PresentationFrameNumber;
  UINT                        DirtyRectCount;
  BOOL                        HwProtectedSurface;
  UINT64                      PresentDisplayQPCTime;
  IDXGIResource               *pSurface;
  DXGI_COLOR_SPACE_TYPE       SurfaceColorSpace;
  UINT                        SdrWhiteLevel;
  IDDCX_SYSTEM_BUFFER_INFO    SystemBufferInfo;
  IDDCX_HDR10_FRAME_METADATA  Hdr10FrameMetaData;
};

メンバー

Size

構造体の合計サイズ (バイト単位)。

ValidFlags

この構造体のどのフィールドに有効なコンテンツ が 含まれているかを示すIDDCX_METADATA2_VALID_FLAGS値のビットごとの OR。

PresentationFrameNumber

このサーフェスのプレゼンテーション フレーム番号。

DirtyRectCount

このフレームのダーティ rect の数。 IddCxSwapChainGetDirtyRects を呼び出して、ダーティの rects を取得します。

DirtyRectCount が 1 の場合、単一のダーティの rect にすべての値が 0 に設定されている場合は、前のフレームからイメージが更新されていないことを示します。 このような状況では、ドライバーは、ビジュアルの品質を向上させるために、デスクトップ イメージをもう一度エンコードする機会があります。 更新プログラムがなくなったら、OS は IDDCX_ADAPTER_CAPS::StaticDesktopReencodeFrameCount 値で示された回数だけ同じフレームを表示し、次の更新まで表示を停止します。

HwProtectedSurface

指定されたサーフェスがハードウェアで保護されているかどうかを示します。

PresentDisplayQPCTime

間接ディスプレイ・モニターにこの画面を表示する必要があるシステム QPC 時刻。

pSurface

エンコードおよび送信するイメージを含む IDXGIResource DX サーフェスへのポインター。 ドライバーは、 IddCxSwapChainReleaseAndAcquire が再度呼び出されるまで、いつでもこの DX サーフェスを使用できます。

SurfaceColorSpace

指定したサーフェスの色空間を示すDXGI_COLOR_SPACE_TYPE値。 色空間は、通常、コミットされたパスで指定された色空間と一致します。

SdrWhiteLevel

SDR コンテンツの白レベル (nit)。たとえば、マウス カーソルなどです。 この値は、HDR 以外のモードでは常に 80 ニットに設定されます。

SystemBufferInfo

リリースおよび取得操作から得られた情報が返されるIDDCX_SYSTEM_BUFFER_INFO構造体。

Hdr10FrameMetaData

このフレームで使用する HDR10 メタデータを含む IDDCX_HDR10_FRAME_METADATA 構造体。

注釈

HDR サポートの詳細については、「 IddCx バージョン 1.10 の更新プログラム」を参照してください。

要件

こちらもご覧ください

IDARG_OUT_RELEASEANDACQUIREBUFFER2

IddCxSwapChainReleaseAndAcquireBuffer2