D3DDDI_MULTIPLANE_OVERLAY_ATTRIBUTES-Struktur (d3dumddi.h)

Artikel
02/23/2024

Wird vom Anzeigetreiber für den Benutzermodus verwendet, um Überlagerungsebenenattribute anzugeben.

Syntax

typedef struct _D3DDDI_MULTIPLANE_OVERLAY_ATTRIBUTES {
  UINT                                         Flags;
  RECT                                         SrcRect;
  RECT                                         DstRect;
  RECT                                         ClipRect;
  D3DDDI_ROTATION                              Rotation;
  D3DDDI_MULTIPLANE_OVERLAY_BLEND              Blend;
  UINT                                         DirtyRectCount;
  RECT                                         *pDirtyRects;
  UINT                                         NumFilters;
  void                                         *pFilters;
  D3DDDI_MULTIPLANE_OVERLAY_VIDEO_FRAME_FORMAT VideoFrameFormat;
  UINT                                         YCbCrFlags;
  D3DDDI_MULTIPLANE_OVERLAY_STRETCH_QUALITY    StretchQuality;
} D3DDDI_MULTIPLANE_OVERLAY_ATTRIBUTES;

Member

Flags

Gibt einen Flipvorgang als einen der anwendbaren Werte in der D3DDDI_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 alle zusätzlichen Ausschnitte 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 Mischmodus an, der für diese Überlagerungsebene gilt, und die darunter liegende Ebene, die als Wert aus der D3DDDI_MULTIPLANE_OVERLAY_BLEND-Enumeration angegeben wird.

DirtyRectCount

Die Anzahl der modifiziert Rechtecke, die für die Überlagerungsebene angegeben sind. Bei Null gilt die gesamte Ebene als modifiziert.

pDirtyRects

Ein Zeiger auf ein Array von modifiziert Rechtecks (RECTs) relativ zum Quellrechteck SrcRect, das den geänderten Teil der Überlagerungsebene angibt.

Der Treiber kann diesen Member verwenden, um Optimierungen durchzuführen, obwohl es nicht erforderlich ist, die modifiziert Rechteckinformationen zu verwenden. Der Treiber sollte jedoch nie einen Funktionsaufruf basierend auf den bereitgestellten modifiziert Rechtecken fehlschlagen.

NumFilters

Gibt optional die Anzahl der Filter an, die der Treiber und die Hardware auf der Überlagerungsebene implementieren. Beachten Sie, dass das Betriebssystem diesen Member ignoriert.

pFilters

Ein optionaler Zeiger auf einen Puffer, der die Filter angibt, die der Treiber und die Hardware auf der Überlagerungsebene implementieren. Beachten Sie, dass das Betriebssystem diesen Member ignoriert.

VideoFrameFormat

Gibt das Videoframeformat der Überlagerungsebene an, das als Wert aus der D3DDDI_MULTIPLANE_OVERLAY_VIDEO_FRAME_FORMAT-Enumeration angegeben wird.

Hinweis Dieser Wert muss immer DXGI_DDI_MULIIPLANE_OVERLAY_VIDEO_FRAME_FORMAT_PROGRESSIVE sein. Die anderen Enumerationswerte werden vom Betriebssystem nicht unterstützt.

YCbCrFlags

Gibt den YUV-Bereich und die Konvertierungsinformationen an, die als Wert aus der D3DDDI_MULTIPLANE_OVERLAY_YCbCr_FLAGS-Enumeration angegeben werden.

StretchQuality

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

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 8.1
Unterstützte Mindestversion (Server)	Windows Server 2012 R2
Kopfzeile	d3dumddi.h (include D3dumddi.h)