D3DDDIARG_PRESENT1 Struktur (d3dumddi.h)

Artikel
02/06/2025

Beschreibt eine anzuzeigende Ressource. Wird mit der pfnPresent1(D3D)--Funktion von Windows Display Driver Model (WDDM) 1.3 und höher von Benutzermodusanzeigetreibern verwendet.

Syntax

typedef struct _D3DDDIARG_PRESENT1 {
  [in] const D3DDDIARG_PRESENTSURFACE *phSrcResources;
  [in] UINT                           SrcResources;
  [in] HANDLE                         hDstResource;
       UINT                           DstSubResourceIndex;
  [in] D3DDDI_PRESENTFLAGS            Flags;
  [in] D3DDDI_FLIPINTERVAL_TYPE       FlipInterval;
       UINT                           Reserved;
  [in] const RECT                     *pDirtyRects;
  [in] UINT                           DirtyRects;
       UINT                           BackBufferMultiplicity;
} D3DDDIARG_PRESENT1;

Angehörige

[in] phSrcResources

Ein Array von nicht-NULL- Handles und nullbasierten Indizes für die Quellressource, die angezeigt oder freigegeben werden soll. phSrcResources ist immer ein gültiger Handle für eine anzuzeigende Ressource.

[in] SrcResources

Die Anzahl der Quellressourcen im Array, auf die durch phSrcResources verwiesen wird.

[in] hDstResource

Ein Handle für die Zielressource, für die angezeigt werden soll. Wenn NULL-, ist das Ziel unbekannt, und der Anzeigeminiporttreiber bestimmt das Ziel direkt vor dem Verarbeiten des Hardwarebefehlsstreams.

DstSubResourceIndex

[in] Der nullbasierte Index in der Zielressource, der durch das Handle im hDstResource Member angegeben wird. Dieser Index gibt die Unterressource oder Oberfläche an, für die angezeigt werden soll.

[in] Flags

Eine D3DDDI_PRESENTFLAGS Struktur, die in Bitfeldkennzeichnungen die Anzeige identifiziert.

[in] FlipInterval

Ein D3DDDI_FLIPINTERVAL_TYPE-typisierter Wert, der das Flip-Intervall angibt (d. a., wenn der Flip nach Null, 1, zwei, drei oder vier vertikalen Synchronisierungen erfolgt).

Reserved

Dieses Element ist reserviert und sollte auf Null festgelegt werden.

[in] 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.

[in] DirtyRects

Die Anzahl der schmutzigen Rechtecke im Array, auf die durch pDirtyRectsverwiesen wird.

BackBufferMultiplicity

Die Anzahl der physischen Hintergrundpuffer pro logischem Hintergrundpuffer.