DXGK_MULTIPLANE_OVERLAY_ATTRIBUTES3结构（d3dkmddi.h）

包含多平面覆盖中图像的属性的结构。

语法

typedef struct _DXGK_MULTIPLANE_OVERLAY_ATTRIBUTES3 {
  DXGK_MULTIPLANE_OVERLAY_FLAGS           Flags;
  RECT                                    SrcRect;
  RECT                                    DstRect;
  RECT                                    ClipRect;
  D3DDDI_ROTATION                         Rotation;
  DXGK_MULTIPLANE_OVERLAY_BLEND           Blend;
  D3DDDI_COLOR_SPACE_TYPE                 ColorSpaceType;
  DXGK_MULTIPLANE_OVERLAY_STRETCH_QUALITY StretchQuality;
  UINT                                    SDRWhiteLevel;
  UINT                                    DirtyRectCnt;
  const RECT                              *pDirtyRects;
} DXGK_MULTIPLANE_OVERLAY_ATTRIBUTES3;

成员

Flags

通过 Oring 值在 DXGK_MULTIPLANE_OVERLAY_FLAGS 枚举中指定翻转作的组合。

SrcRect

指定 RECT 类型的源矩形，相对于源资源。

DstRect

指定 RECT 类型相对于监视器分辨率的目标矩形。

ClipRect

根据 SrcRect 和 DstRect 的值拉伸数据后，指定 RECT 类型的其他剪辑信息（相对于 DstRect 矩形）。

当应用遮挡 DstRect 目标矩形的一部分时，驱动程序和硬件可以使用 ClipRect 成员应用常见的拉伸因子。

Rotation

指定覆盖平面的顺时针旋转，作为D3DDDI_ROTATION枚举中的值提供。

Blend

指定应用于此覆盖平面及其下方的平面的混合模式，作为 DXGK_MULTIPLANE_OVERLAY_BLEND 枚举中的值提供。

ColorSpaceType

指定颜色空间配置，以 D3DDDI_COLOR_SPACE_TYPE 枚举中的值的形式提供。

StretchQuality

指定覆盖平面的拉伸质量，以 DXGK_MULTIPLANE_OVERLAY_STRETCH_QUALITY 枚举中的值的形式提供。

SDRWhiteLevel

指定驱动程序应映射 sRGB 1.0 的 nits 中的值。

对于 HDR 内容，这始终为 0。

对于 SDR（标准动态范围）内容，值为 0 表示驱动程序应将 sRGB 1.0 映射到默认值，即 80 nits。

当不在 HDR 模式下时，将忽略此值。

DirtyRectCnt

pDirtyRects 的脏矩形数。

pDirtyRects

脏矩形的指针。

言论

WDDM 2.3 驱动程序需要检查传入 CheckMultiPlaneOverlaySupport3 回调中传递的 SDRWhiteLevel 值，如果硬件无法调整 SDR 内容的相对亮度，则返回不受支持。

将 SDR 内容提升到 SDRWhiteLevel 时，缩放必须在线性空间中发生。

要求

要求	价值
最低支持的客户端	Windows 10 版本 1803
标头	d3dkmddi.h