PFND3DDDI_PRESENTMULTIPLANEOVERLAYCB Rückruffunktion (d3dumddi.h)

Artikel
02/26/2024

Kopiert Inhalt aus einer Mehrplanen-Quellüberlagerungszuordnung in eine Zielzuordnung. Kann von Windows Display Driver Model (WDDM) 1.3 oder höher für 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 von unzureichendem Arbeitsspeicher nicht abgeschlossen werden.
E_INVALIDARG	Die Parameter wurden überprüft und als falsch ermittelt.

Hinweise

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

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

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

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 8.1
Unterstützte Mindestversion (Server)	Windows Server 2012 R2
Zielplattform	Desktop
Kopfzeile	d3dumddi.h (include D3dumddi.h)

Weitere Informationen

D3DDDIARG_PRESENTMULTIPLANEOVERLAY

D3DDDICB_PRESENTMULTIPLANEOVERLAY

pfnPresentMultiplaneOverlay (D3D)

Share via