iddcx.h) (IDDCX_METADATA2 结构

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

此帧的脏矩形数。 调用 IddCxSwapChainGetDirtyRects 以获取脏。

DirtyRectCount 为 1，其中单个脏 rect 的所有值都设置为零，指示上一帧中没有任何图像更新。 在这种情况下，驱动程序有机会再次重新编码桌面图像以提高视觉质量。 一旦不再有更新，OS 会按照 IDDCX_ADAPTER_CAPS：：StaticDesktopReencodeFrameCount 值 指示的次数显示同一帧，然后停止呈现，直到下一次更新。

HwProtectedSurface

指示提供的表面是否受硬件保护。

PresentDisplayQPCTime

此图面应显示在间接显示监视器上的系统 QPC 时间。

pSurface

指向 IDXGIResource DX 图面的指针，该图面包含要编码和传输的图像。 驱动程序可以随时使用此 DX 图面，直到再次调用 IddCxSwapChainReleaseAndAcquire 。

SurfaceColorSpace

指示所提供图面的颜色空间的 DXGI_COLOR_SPACE_TYPE 值。 颜色空间通常与提交路径中指定的颜色空间匹配。

SdrWhiteLevel

任何 SDR 内容的白色级别（以尼特为单位）;例如鼠标光标。 对于非 HDR 模式，此值始终默认为 80 尼特。

SystemBufferInfo

一个IDDCX_SYSTEM_BUFFER_INFO结构，其中返回来自发布和获取操作的结果信息。

Hdr10FrameMetaData

包含要用于此帧的 HDR10 元数据 的IDDCX_HDR10_FRAME_METADATA 结构。

注解

有关 HDR 支持的详细信息，请参阅 IddCx 版本 1.10 更新。

要求

要求	值
最低受支持的客户端	Windows 11，版本 22H2 9 月更新 (IddCx 版本 1.10)
标头	iddcx.h

另请参阅

IDARG_OUT_RELEASEANDACQUIREBUFFER2

IddCxSwapChainReleaseAndAcquireBuffer2