DXGK_MULTIPLANE_OVERLAY_PLANE3-Struktur (d3dkmddi.h)

  • Artikel

Gibt eine Überlagerungsebene an, die in einem Aufruf der DxgkDdiSetVidPnSourceAddressWithMultiPlaneOverlay3-Funktion angezeigt werden soll.

Syntax

typedef struct _DXGK_MULTIPLANE_OVERLAY_PLANE3 {
  UINT                                LayerIndex;
  ULONGLONG                           PresentId;
  DXGK_PLANE_SPECIFIC_INPUT_FLAGS     InputFlags;
  DXGK_PLANE_SPECIFIC_OUTPUT_FLAGS    OutputFlags;
  UINT                                MaxImmediateFlipLine;
  UINT                                ContextCount;
  DXGK_PRIMARYCONTEXTDATA             **ppContextData;
  UINT                                DriverPrivateDataSize;
  PVOID                               pDriverPrivateData;
  DXGK_MULTIPLANE_OVERLAY_ATTRIBUTES3 PlaneAttributes;
} DXGK_MULTIPLANE_OVERLAY_PLANE3;

Member

LayerIndex

Der nullbasierte Index der anzuzeigenden Überlagerungsebene. Die oberste Ebene (in Z-Richtung) weist index null auf. Die Indexwerte der Ebenen müssen von oben nach unten sequenziell sein.

PresentId

Ein 64-Bit-Bezeichner pro Ebene, der vom Treiber verwendet wird, um den Abschluss des Overlaybefehls zu melden.

InputFlags

Eine DXGK_PLANE_SPECIFIC_INPUT_FLAGS-Struktur , die alle ebenenspezifischen Anzeigevorgänge identifiziert, die ausgeführt werden sollen.

OutputFlags

Eine DXGK_PLANE_SPECIFIC_OUTPUT_FLAGS-Struktur, die vom Treiber zurückgegebene status enthält.

MaxImmediateFlipLine

Die Anzeigelinie, die angibt, ob ein VSYNC-Flip zu einem sofortigen Flip heraufgestuft werden soll, wobei Zeile 0 dem ersten aktiven Pixel des Frames entspricht. Dieser Wert wird für Nicht-VSYNC-Flips ignoriert.

Dieser Wert ist -1, wenn eine Heraufstufung von einem VSYNC-Flip zu einem sofortigen Flip nicht gewünscht ist. In diesem Fall wartet das Flip immer auf die nächste VSYNC.

Bei einem anderen Wert als -1 sollte der Treiber diesen Flip zu einem sofortigen Flip höherstufen, wenn der HW noch nicht mit dem Lesen aus der angegebenen Anzeigelinie begonnen hat. Werte von 0 können zu sofortigen Flips heraufgestuft werden, wenn der HW über latchte Register für den aktuellen Anzeigerahmen verfügt, aber noch nicht mit dem Scannen des ersten aktiven Pixels begonnen hat.

Der Anzeigezeilenwert ist relativ zum festgelegten physischen Modus. Wenn die Anzeige eine Skalierung ausführt, ist die Anzeigelinie relativ zur Größe, nachdem die Skalierung angewendet wurde.

Wenn ein VSYNC-Flip zu einem sofortigen Flip heraufgestuft wird, sollte der Treiber DXGK_PLANE_SPECIFIC_OUTPUT_FLAGS festlegen. FlipConvertedToImmediate auf TRUE.

ContextCount

Die Anzahl der Kontexte im Array, die vom Kontextelement angegeben wird.

ppContextData

Ein Array von Handles für die Kontexte, die zu einem Anzeigevorgang beigetragen haben.

DriverPrivateDataSize

Die Größe der privaten Treiberdaten.

pDriverPrivateData

Private Treiberdaten.

PlaneAttributes

Eine Struktur vom Typ DXGK_MULTIPLANE_OVERLAY_ATTRIBUTES3 , die Überlagerungsebenenattribute angibt.

Anforderungen

Anforderung Wert
Header d3dkmddi.h