DXGK_MULTIPLANE_OVERLAY_ATTRIBUTES Struktur (d3dkmddi.h)

Artikel
02/06/2025

Wird vom Anzeigeminiporttreiber zum Angeben von Overlayebenenattributen verwendet.

Syntax

typedef struct _DXGK_MULTIPLANE_OVERLAY_ATTRIBUTES {
  DXGK_MULTIPLANE_OVERLAY_FLAGS              Flags;
  RECT                                       SrcRect;
  RECT                                       DstRect;
  RECT                                       ClipRect;
  D3DDDI_ROTATION                            Rotation;
  DXGK_MULTIPLANE_OVERLAY_BLEND              Blend;
  UINT                                       NumFilters;
  void                                       *pFilters;
  DXGK_MULTIPLANE_OVERLAY_VIDEO_FRAME_FORMAT VideoFrameFormat;
  DXGK_MULTIPLANE_OVERLAY_YCbCr_FLAGS        YCbCrFlags;
  DXGK_MULTIPLANE_OVERLAY_STEREO_FORMAT      StereoFormat;
  BOOL                                       StereoLeftViewFrame0;
  BOOL                                       StereoBaseViewFrame0;
  DXGK_MULTIPLANE_OVERLAY_STEREO_FLIP_MODE   StereoFlipMode;
  DXGK_MULTIPLANE_OVERLAY_STRETCH_QUALITY    StretchQuality;
} DXGK_MULTIPLANE_OVERLAY_ATTRIBUTES;

Angehörige

Flags

Gibt einen Flip-Vorgang als einen der anwendbaren Konstantenwerte in der DXGK_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 DXGK_MULTIPLANE_OVERLAY_BLEND-Aufzählung angegeben wird.

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 DXGK_MULTIPLANE_OVERLAY_VIDEO_FRAME_FORMAT-Enumeration angegeben wird.

Hinweis Dieser Wert muss immer DXGK_MULTIPLANE_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 DXGK_MULTIPLANE_OVERLAY_YCbCr_FLAGS-Aufzählung angegeben werden.

StereoFormat

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

Hinweis Dieser Wert muss immer DXGK_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 DXGK_MULTIPLANE_OVERLAY_STEREO_FLIP_MODE-Aufzählung angegeben wird.

Hinweis Dieser Wert muss immer DXGK_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 DXGK_MULTIPLANE_OVERLAY_STRETCH_QUALITY-Enumeration angegeben wird.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Windows 8.1
mindestens unterstützte Server-	Windows Server 2012 R2
Header-	d3dkmddi.h (einschließlich D3dkmddi.h)