DXGI_DDI_MULTIPLANE_OVERLAY_ATTRIBUTES-Struktur (dxgiddi.h)

Artikel
08/07/2023

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

Syntax

typedef struct DXGI_DDI_MULTIPLANE_OVERLAY_ATTRIBUTES {
  UINT                                           Flags;
  RECT                                           SrcRect;
  RECT                                           DstRect;
  RECT                                           ClipRect;
  DXGI_DDI_MODE_ROTATION                         Rotation;
  DXGI_DDI_MULTIPLANE_OVERLAY_BLEND              Blend;
  UINT                                           DirtyRectCount;
  RECT                                           *pDirtyRects;
  UINT                                           NumFilters;
  void                                           *pFilters;
  DXGI_DDI_MULTIPLANE_OVERLAY_VIDEO_FRAME_FORMAT VideoFrameFormat;
  UINT                                           YCbCrFlags;
  DXGI_DDI_MULTIPLANE_OVERLAY_STEREO_FORMAT      StereoFormat;
  BOOL                                           StereoLeftViewFrame0;
  BOOL                                           StereoBaseViewFrame0;
  DXGI_DDI_MULTIPLANE_OVERLAY_STEREO_FLIP_MODE   StereoFlipMode;
  DXGI_DDI_MULTIPLANE_OVERLAY_STRETCH_QUALITY    StretchQuality;
} DXGI_DDI_MULTIPLANE_OVERLAY_ATTRIBUTES;

Member

Flags

Gibt einen Flip-Vorgang als einen der anwendbaren Werte in der DXGI_DDI_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 Clippings 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 der 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 DXGI_DDI_MODE_ROTATION-Enumeration angegeben wird.

Blend

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

DirtyRectCount

Die Anzahl der modifiziert Rechtecke, die für die Überlagerungsebene angegeben sind. Wenn null, wird die gesamte Ebene als modifiziert betrachtet.

pDirtyRects

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

Der Treiber kann dieses Element 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 Rechtecks 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 DXGI_DDI_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 YUV-Bereich und Konvertierungsinformationen als einen der anwendbaren Werte in der DXGI_DDI_MULTIPLANE_OVERLAY_YCbCr_FLAGS-Enumeration an.

StereoFormat

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

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

StereoLeftViewFrame0

Ist für das System reserviert. Muss immer FALSE sein.

StereoBaseViewFrame0

Ist für das System reserviert. Muss immer FALSE sein.

StereoFlipMode

Gibt den Stereo-Flipmodus der Überlagerungsebene an, der als Wert aus der DXGI_DDI_MULTIPLANE_OVERLAY_STEREO_FLIP_MODE-Enumeration angegeben wird.

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

StretchQuality

Gibt die Stretchqualität der Überlagerungsebene an, die als Wert aus der DXGI_DDI_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	dxgiddi.h (include D3d10umddi.h)