D3DDDI_MULTIPLANE_OVERLAY_ATTRIBUTES Struktur (d3dumddi.h)

Artikel
02/06/2025

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;

Angehörige

Flags

Gibt einen Flip-Vorgang als einen der anwendbaren Werte in der D3DDDI_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 D3DDDI_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 D3DDDI_MULTIPLANE_OVERLAY_BLEND-Aufzählung 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 D3DDDI_MULTIPLANE_OVERLAY_VIDEO_FRAME_FORMAT-Enumeration 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 an, die als Wert aus der D3DDDI_MULTIPLANE_OVERLAY_YCbCr_FLAGS-Aufzählung angegeben werden.

StretchQuality

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