DXGK_MULTIPLANE_OVERLAY_ATTRIBUTES3 Struktur (d3dkmddi.h)

Eine Struktur, die die Attribute enthält, die für das Bild in einer Mehrebenenüberlagerung verwendet werden.

Syntax

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;

Member

Flags

Gibt eine Kombination von Flipvorgängen durch Oring-Werte in der DXGK_MULTIPLANE_OVERLAY_FLAGS-Enumeration an.

SrcRect

Gibt das Quellrechteck vom Typ RECT relativ zur Quellressource an.

DstRect

Gibt das Zielrechteck vom Typ RECT relativ zur Monitorauflösung an.

ClipRect

Gibt zusätzliche Beschneidungsinformationen vom Typ RECT relativ zum DstRect-Rechteck an, nachdem die Daten gemäß den Werten von SrcRect und DstRect gestreckt wurden.

Der Treiber und die Hardware können den ClipRect-Member verwenden, um einen allgemeinen Stretchfaktor anzuwenden, wenn sich das Clipping ändert, wenn eine App einen Teil des DstRect-Zielrechtecks verdeckt.

Rotation

Gibt die Drehung der Überlagerungsebene im Uhrzeigersinn an, die als Wert aus der D3DDDI_ROTATION-Enumeration angegeben wird.

Blend

Gibt den Füllmodus an, der für diese Überlagerungsebene gilt, und die darunter liegende Ebene, die als Wert aus der DXGK_MULTIPLANE_OVERLAY_BLEND-Enumeration angegeben wird.

ColorSpaceType

Gibt die Farbraumkonfiguration an, die als Wert aus der D3DDDI_COLOR_SPACE_TYPE-Enumeration angegeben wird.

StretchQuality

Gibt die Stretchqualität der Überlagerungsebene an, die als Wert aus der DXGK_MULTIPLANE_OVERLAY_STRETCH_QUALITY-Enumeration angegeben wird.

SDRWhiteLevel

Gibt den Wert in nits an, den der Treiber sRGB 1.0 zuordnen soll.

Bei HDR-Inhalten ist dies immer 0.

Für SDR-Inhalte (Standarddynamikbereich) gibt der Wert 0 an, dass der Treiber sRGB 1.0 dem Standardwert 80 Nits zuordnen soll.

Dieser Wert wird ignoriert, wenn er sich nicht im HDR-Modus befindet.

DirtyRectCnt

Die Anzahl der modifiziert Rechtecke von pDirtyRects.

pDirtyRects

Zeiger des modifiziert Rechtecks.

Hinweise

WDDM 2.3-Treiber müssen den im CheckMultiPlaneOverlaySupport3-Rückruf übergebenen SDRWhiteLevel-Wert überprüfen und nicht unterstützt zurückgeben, wenn die Hardware die relative Helligkeit des SDR-Inhalts nicht anpassen kann.

Beim Erhöhen des SDR-Inhalts auf SDRWhiteLevel muss die Skalierung im linearen Raum erfolgen.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 10, Version 1803
Kopfzeile	d3dkmddi.h