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 |