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 の更新プログラム」を参照してください。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows 11、バージョン 22H2 9 月の更新プログラム (IddCx バージョン 1.10) |
| Header | iddcx.h |