PFND3DDDI_PRESENTMULTIPLANEOVERLAYCB Rückruffunktion (d3dumddi.h)

Artikel
02/06/2025

Kopiert Inhalte aus einer Quellüberlagerungsüberlagerungszuordnung in eine Zielzuordnung. Kann von Windows Display Driver Model (WDDM) 1.3 oder höher vom Benutzermodus-Anzeigetreiber aufgerufen werden.

Syntax

PFND3DDDI_PRESENTMULTIPLANEOVERLAYCB Pfnd3dddiPresentmultiplaneoverlaycb;

HRESULT Pfnd3dddiPresentmultiplaneoverlaycb(
  HANDLE hDevice,
  const D3DDDICB_PRESENTMULTIPLANEOVERLAY *unnamedParam2
)
{...}

Parameter

hDevice

Ein Handle für ein Anzeigegerät (Grafikkontext).

unnamedParam2

pPresent- [in]

Ein Zeiger auf eine D3DDDICB_PRESENTMULTIPLANEOVERLAY Struktur, die die Quell- und Zielzuordnungen beschreibt, aus denen Inhalte kopiert werden.

Rückgabewert

Gibt einen der folgenden Werte zurück:

Rückgabecode	Beschreibung
S_OK	Der Inhalt wurde erfolgreich kopiert.
E_OUTOFMEMORY	Die Funktion konnte aufgrund unzureichender Arbeitsspeichers nicht abgeschlossen werden.
E_INVALIDARG	Parameter wurden überprüft und ermittelt, dass sie falsch sind.

Bemerkungen

Der Anzeigetreiber für den Benutzermodus sollte diese Funktion erst aufrufen, nachdem er erfolgreich einen Aufruf der Microsoft DirectX Graphics Infrastructure (DXGI)-Laufzeit an die pfnPresentMultiplaneOverlay (D3D) Funktion verarbeitet hat.

Hinweis Wenn der Anzeigetreiber pfnPresentMultiPlaneOverlayCb (D3D)-aufruft, muss er dieselbe Reihenfolge der Zuordnungen im AllocationInfo Arraymemm der D3DDDICB_PRESENTMULTIPLANEOVERLAY-Struktur beibehalten, wie es von der Microsoft Direct3D-Laufzeit empfangen wird, wenn die Laufzeit pfnPresentMultiplaneOverlay (D3D).

Beispielsweise muss der Zuordnungshandle in Index 1 von AllocationInfo- dieselbe Ressource darstellen, die an den Treiber in Index 1 der pPresentPlanes Member der D3DDDIARG_PRESENTMULTIPLANEOVERLAY Struktur übergeben wurde, die mit pfnPresentMultiplaneOverlay (D3D)verwendet wird.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Windows 8.1
mindestens unterstützte Server-	Windows Server 2012 R2
Zielplattform-	Desktop
Header-	d3dumddi.h (include D3dumddi.h)

Siehe auch

D3DDDIARG_PRESENTMULTIPLANEOVERLAY

D3DDDICB_PRESENTMULTIPLANEOVERLAY

pfnPresentMultiplaneOverlay (D3D)

Freigeben über