D3DDDIARG_PRESENT1-Struktur (d3dumddi.h)

Artikel
02/23/2024

Beschreibt eine anzuzeigende Ressource. Wird mit der PfnPresent1(D3D) -Funktion von Windows Display Driver Model (WDDM) 1.3 und höheren Benutzermodus-Anzeigetreibern 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;

Member

[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ültiges Handle für eine Ressource, die angezeigt werden soll.

[in] SrcResources

Die Anzahl der Quellressourcen im Array, auf das von phSrcResources verwiesen wird.

[in] hDstResource

Ein Handle für die Zielressource, für die angezeigt werden soll. Bei NULL ist das Ziel unbekannt, und der Anzeige-Miniporttreiber bestimmt das Ziel unmittelbar vor der Verarbeitung des Hardwarebefehlsdatenstroms.

DstSubResourceIndex

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

[in] Flags

Eine D3DDDI_PRESENTFLAGS Struktur, die in Bitfeldflags die Anzeige angibt.

[in] FlipInterval

Ein D3DDDI_FLIPINTERVAL_TYPE typisierter Wert, der das Flipintervall angibt (d. a. wenn der Flip nach 0, 1, zwei, drei oder vier vertikalen Synchronisierungen auftritt).

Reserved

Dieser Member ist reserviert und sollte auf 0 (null) festgelegt werden.

[in] pDirtyRects

Ein Zeiger auf ein Array von modifiziert Rechtecke (RECTs) relativ zum Quellrechteck SrcRect, das den geänderten Teil der Überlagerungsebene angibt.

Der Treiber kann dieses Element verwenden, um Optimierungen durchzuführen, obwohl es nicht erforderlich ist, die modifiziert Rechteckinformationen zu verwenden. Der Treiber sollte jedoch nie einen Funktionsaufruf basierend auf den bereitgestellten modifiziert Rechtecks fehlschlagen.

[in] DirtyRects

Die Anzahl der modifiziert Rechtecke im Array, auf das von pDirtyRects verwiesen wird.

BackBufferMultiplicity

Die Anzahl des physischen Backpuffers pro logischem Backpuffer.