DXGI_DDI_MULTIPLANE_OVERLAY_ATTRIBUTES Struktur (dxgiddi.h)

Artikel
02/06/2025

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;

Angehörige

Flags

Gibt einen Flip-Vorgang als einen der anwendbaren Werte in der DXGI_DDI_MULTIPLANE_OVERLAY_FLAGS-Aufzählung 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 einen zusätzlichen Clipping vom Typ RECT, relativ zum DstRect Rechteck an, nachdem die Daten gemäß den Werten SrcRect und DstRectgestreckt 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 Zielrechteck verdeckt.

Rotation

Gibt die Drehung im Uhrzeigersinn der Überlagerungsebene an, die als Wert aus der DXGI_DDI_MODE_ROTATION-Aufzählung angegeben wird.

Blend

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

DirtyRectCount

Die Anzahl der für die Überlagerungsebene angegebenen schmutzigen Rechtecke. Wenn null, wird die gesamte Ebene als schmutzig betrachtet.

pDirtyRects

Ein Zeiger auf ein Array von schmutzigen Rechtecken (RECTs), relativ zum Quellrechteck SrcRect, die den Teil der Überlagerungsebene angeben, die geändert wurde.

Der Treiber kann dieses Element verwenden, um Optimierungen durchzuführen, obwohl es nicht erforderlich ist, die schmutzigen Rechteckinformationen zu verwenden. Der Treiber sollte jedoch niemals einen Funktionsaufruf basierend auf den bereitgestellten schmutzigen 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 dieses Mitglied 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 dieses Mitglied ignoriert.

VideoFrameFormat

Gibt das Videoframeformat der Überlagerungsebene an, der als Wert aus der DXGI_DDI_MULTIPLANE_OVERLAY_VIDEO_FRAME_FORMAT-Aufzählung angegeben wird.

Hinweis Dieser Wert muss immer DXGI_DDI_MULIIPLANE_OVERLAY_VIDEO_FRAME_FORMAT_PROGRESSIVEsein. Das Betriebssystem unterstützt die anderen Enumerationswerte nicht.

YCbCrFlags

Gibt YUV-Bereichs- und Konvertierungsinformationen als einen der anwendbaren Werte in der DXGI_DDI_MULTIPLANE_OVERLAY_YCbCr_FLAGS-Aufzählung an.

StereoFormat

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

Hinweis Dieser Wert muss immer DXGI_DDI_MULTIPLANE_OVERLAY_STEREO_FORMAT_MONOsein. Das Betriebssystem unterstützt die anderen Enumerationswerte nicht.

StereoLeftViewFrame0

Reserviert für die Systemverwendung. Muss immer FALSE-sein.

StereoBaseViewFrame0

Reserviert für die Systemverwendung. Muss immer FALSE-sein.

StereoFlipMode

Gibt den Stereo-Flip-Modus 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_NONEsein. Das Betriebssystem unterstützt die anderen Enumerationswerte nicht.

StretchQuality

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