DXGI_DDI_ARG_PRESENT1 Struktur (dxgiddi.h)
Beschreibt eine anzuzeigende Ressource. Wird mit der pfnPresent1(DXGI)--Funktion von Windows Display Driver Model (WDDM) 1.3 und höher von Anzeigetreibern für den Benutzermodus 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;
Angehörige
[in] hDevice
Ein Handle für das Anzeigegerät (Grafikkontext), auf dem der Treiber die Präsentation ausführt. Die Direct3D-Laufzeit übergibt dieses Handle an den Treiber in der hDrvDevice Member der D3D10DDIARG_CREATEDEVICE Struktur, wenn die Laufzeit 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ültiger Handle für eine anzuzeigende Ressource.
[in] SurfacesToPresent
Das Array der zu präsentierenden Oberflächen. Darf nicht null sein.
[in] hDstResource
Ein Handle für die Zielressource, für die angezeigt werden soll. hDstResource- kann NULL- sein, wenn das Ziel unbekannt ist; Der Kernelmodus bestimmt das Ziel direkt vor dem Senden des Hardwarebefehlsstreams über DMA an den Grafikprozessor.
Wenn viele Ressourcen angezeigt werden, wird hDstResource-NULL-, und der Treiber muss nur den letzten Quellressourcenhandle für die Verwendung mit der pfnPresentCb--Funktion übersetzen.
[in] DstSubResourceIndex
Der nullbasierte Index in der Zielressource, den das Handle im hDstResource Member angibt. Der DstSubResourceIndex Index gibt die Unterressource oder Oberfläche an, für die angezeigt werden soll.
[in] pDXGIContext
Ein Handle für den DXGI-Kontext. Dieser Handle ist für den Treiber nicht transparent. Der Treiber muss das Handle in diesem Element als pDXGIContext Member der DXGIDDICB_PRESENT Struktur übergeben, wenn der Treiber die pfnPresentCbDXGI--Funktion aufruft.
[in] Flags
Eine DXGI_DDI_PRESENT_FLAGS Struktur, die den aktuellen Vorgang in Bitfeldkennzeichnungen identifiziert.
[in] FlipInterval
Ein DXGI_DDI_FLIP_INTERVAL_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.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Windows 8.1,WDDM 1.3 und höher |
| mindestens unterstützte Server- | Windows Server 2012 R2 |
| Header- | dxgiddi.h (include D3d10umddi.h) |