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

藉由 DXGK_MULTIPLANE_OVERLAY_FLAGS 列舉中的 Oring 值，指定翻轉作業的組合。

SrcRect

指定相對於來源資源類型 RECT 的來源矩形。

DstRect

指定 RECT 類型的目的地矩形，相對於監視解析度。

ClipRect

根據 SrcRect 和 DstRect 的值，指定相對於 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