DXGI_PRESENT_PARAMETERS Struktur (dxgi1_2.h)

Beschreibt Informationen zum Vorhandenen, die dem Betriebssystem helfen, die Präsentation zu optimieren.

Syntax

typedef struct DXGI_PRESENT_PARAMETERS {
  UINT  DirtyRectsCount;
  RECT  *pDirtyRects;
  RECT  *pScrollRect;
  POINT *pScrollOffset;
} DXGI_PRESENT_PARAMETERS;

Member

DirtyRectsCount

Die Anzahl der aktualisierten Rechtecke, die Sie im Backpuffer für den dargestellten Frame aktualisieren. Das Betriebssystem verwendet diese Informationen, um die Präsentation zu optimieren. Sie können diesen Member auf 0 festlegen, um anzugeben, dass Sie den gesamten Frame aktualisieren.

pDirtyRects

Eine Liste der aktualisierten Rechtecke, die Sie im Backpuffer für den dargestellten Frame aktualisieren. Eine Anwendung muss jedes einzelne Pixel in jedem Rechteck aktualisieren, das sie an die Runtime meldet. Die Anwendung kann nicht davon ausgehen, dass die Pixel aus dem vorherigen Frame gespeichert werden. Weitere Informationen zum Aktualisieren modifiziert Rechtecke finden Sie unter Hinweise. Sie können dieses Element auf NULL festlegen, wenn DirtyRectsCount 0 ist. Eine Anwendung darf kein Pixel außerhalb der modifiziert Rechtecke aktualisieren.

pScrollRect

Ein Zeiger auf das gescrollte Rechteck. Das scrollende Rechteck ist das Rechteck des vorherigen Frames, aus dem die Laufzeit Bitblockinhalte (Bitblts) überträgt. Die Runtime verwendet auch das scrollende Rechteck, um die Darstellung in Terminalserver- und indirekten Anzeigeszenarien zu optimieren.

Das scrollende Rechteck beschreibt auch das Zielrechteck, d. h. die Region im aktuellen Frame, die mit gescrollten Inhalten gefüllt ist. Sie können dieses Element auf NULL festlegen, um anzugeben, dass kein Inhalt aus dem vorherigen Frame gescrollt wird.

pScrollOffset

Ein Zeiger auf den Offset des scrollten Bereichs, der vom Quellrechteck (des vorherigen Frames) zum Zielrechteck (des aktuellen Frames) wechselt. Sie können dieses Element auf NULL festlegen, um keinen Offset anzugeben.

Hinweise

Diese Struktur wird von der Present1-Methode verwendet.

Das Bildlaufrechteck und die Liste der modifiziert Rechtecke können sich überlappen. In dieser Situation haben die modifiziert Rechtecke Vorrang. Anwendungen können dann dynamische Inhalte auf einem scrollten Bereich enthalten. Beispielsweise könnte eine Anwendung eine Seite scrollen und gleichzeitig Videos wiedergeben.

Das folgende Diagramm und die folgenden Koordinaten veranschaulichen dieses Beispiel.

DirtyRectsCount = 2
pDirtyRects[ 0 ] = { 10, 30, 40, 50 } // Video
pDirtyRects[ 1 ] = { 0, 70, 50, 80 } // New line
*pScrollRect = { 0, 0, 50, 70 }
*pScrollOffset = { 0, -10 }

Teile des vorherigen Frames und inhalte, die die Anwendung rendert, werden kombiniert, um den endgültigen Frame zu erzeugen, den das Betriebssystem auf dem Bildschirm darstellt. Der größte Teil des Fensters wird aus dem vorherigen Frame gescrollt. Die Anwendung muss den Videoframe mit dem neuen Inhaltsblock aktualisieren, der aufgrund des Bildlaufs angezeigt wird.

Das gestrichelte Rechteck zeigt das Scrollrechteck im aktuellen Frame an. Das Scrollrechteck wird durch das pScrollRect-Element angegeben. Der Pfeil zeigt den Scrolloffset an. Der Bildlaufoffset wird durch das pScrollOffset-Element angegeben. Gefüllte Rechtecke zeigen modifiziert Rechtecke an, die die Anwendung mit neuen Inhalten aktualisiert hat. Die gefüllten Rechtecke werden durch die Elemente DirtyRectsCount und pDirtyRects angegeben.

Das Bildlaufrechteck und der Offset werden für die Option DXGI_SWAP_EFFECT_DISCARD oder DXGI_SWAP_EFFECT_SEQUENTIAL vorhanden nicht unterstützt. Schmutzige Rechtecke und Scrollrechteck werden für mehrstufige Swapchains nicht unterstützt.

Die tatsächliche Implementierung der Komposition und der erforderlichen Bitblts unterscheidet sich für das Bitblt-Modell und das Flip-Modell. Weitere Informationen zu diesen Modellen finden Sie unter DXGI Flip Model.

Weitere Informationen zur Flipmodell-Swapchain und zur Optimierung der Präsentation finden Sie unter Verbessern der Präsentation mit dem Flip-Modell, modifiziert Rechtecke und scrollte Bereiche.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 8 und Plattformupdate für Windows 7 [Desktop-Apps | UWP-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2012 und Plattformupdate für Windows Server 2008 R2 [Desktop-Apps | UWP-Apps]
Kopfzeile	dxgi1_2.h

Weitere Informationen

DXGI-Strukturen