DXGI_DDI_ARG_PRESENT1-Struktur (dxgiddi.h)

Beschreibt eine ressource, die angezeigt werden soll. Wird mit der funktion pfnPresent1(DXGI) von Windows Display Driver Model (WDDM) 1.3 und höher benutzermodusanzeigetreibern verwendet.

Syntax

typedef struct DXGI_DDI_ARG_PRESENT1 {
  [in] DXGI_DDI_HDEVICE                  hDevice;
  [in] const DXGI_DDI_ARG_PRESENTSURFACE *phSurfacesToPresent;
  [in] UINT                              SurfacesToPresent;
  [in] DXGI_DDI_HRESOURCE                hDstResource;
  [in] UINT                              DstSubResourceIndex;
  [in] void                              *pDXGIContext;
  [in] DXGI_DDI_PRESENT_FLAGS            Flags;
  [in] DXGI_DDI_FLIP_INTERVAL_TYPE       FlipInterval;
       UINT                              Reserved;
  [in] const RECT                        *pDirtyRects;
  [in] UINT                              DirtyRects;
       UINT                              BackBufferMultiplicity;
} DXGI_DDI_ARG_PRESENT1;

Member

[in] hDevice

Ein Handle für das Anzeigegerät (Grafikkontext), auf dem der Treiber die Präsentation ausführt. Die Direct3D-Runtime übergibt dieses Handle an den Treiber im hDrvDevice-Member der D3D10DDIARG_CREATEDEVICE-Struktur , wenn die Runtime die CreateDevice(D3D10) -Funktion des Treibers aufruft, um das Anzeigegerät zu erstellen.

[in] phSurfacesToPresent

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

[in] SurfacesToPresent

Das Array der zu präsentierenden Oberflächen. Darf nicht 0 sein.

[in] hDstResource

Ein Handle für die Zielressource, für die angezeigt werden soll. hDstResource kann NULL sein, wenn das Ziel unbekannt ist. im Kernelmodus wird das Ziel bestimmt, bevor der Hardwarebefehlsstream über DMA an den Grafikprozessor gesendet wird.

Wenn viele Ressourcen angezeigt werden, ist hDstResourceNULL, und der Treiber muss nur das letzte Quellressourcenhandle für die Verwendung mit der PfnPresentCb-Funktion übersetzen.

[in] DstSubResourceIndex

Der nullbasierte Index in die Zielressource, den das Handle im hDstResource-Member angibt. Der DstSubResourceIndex-Index gibt die Unterquelle oder Oberfläche an, für die angezeigt werden soll.

[in] pDXGIContext

Ein Handle für den DXGI-Kontext. Dieses Handle ist für den Treiber undurchsichtig. Der Treiber muss das Handle in diesem Member als pDXGIContext-Member der DXGIDDICB_PRESENT-Struktur übergeben, wenn der Treiber die PfnPresentCbDXGI-Funktion aufruft .

[in] Flags

Eine DXGI_DDI_PRESENT_FLAGS-Struktur , die in Bitfeldflags die Ausführung des vorliegenden Vorgangs angibt.

[in] FlipInterval

Ein DXGI_DDI_FLIP_INTERVAL_TYPE typisierter Wert, der das Flipintervall angibt (d. a. wenn die Synchronisierung nach 0, 1, zwei, drei oder vier vertikalen Synchronisierungen erfolgt).

Reserved

Dieser Member ist reserviert und sollte auf null festgelegt werden.

[in] pDirtyRects

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

Der Treiber kann diesen Member 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 Rechtecken fehlschlagen.

[in] DirtyRects

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

BackBufferMultiplicity

Die Anzahl des physischen Backpuffers pro logischem Backpuffer.

Anforderungen

Weitere Informationen

CreateDevice(D3D10)

DXGIDDICB_PRESENT

DXGI_DDI_FLIP_INTERVAL_TYPE

DXGI_DDI_PRESENT_FLAGS

RECT

pfnPresent1(DXGI)

pfnPresentCb

pfnPresentCbDXGI