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

此帧的脏凹槽数。 调用 IddCxSwapChainGetDirtyRects 以获取脏的凹槽。

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

HwProtectedSurface

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

PresentDisplayQPCTime

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

pSurface

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

SurfaceColorSpace

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

SdrWhiteLevel

任何 SDR 内容的白色级别;例如,鼠标光标。 对于非 HDR 模式,此值始终默认为 80 nits。

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