PFNDDXGIDDI_PRESENTCB Rückruffunktion (dxgiddi.h)

Artikel
02/29/2024

Die PfnPresentCbDXGI-Funktion kopiert Inhalt aus einer Quellzuordnung in eine Zielzuordnung.

Syntax

PFNDDXGIDDI_PRESENTCB PfnddxgiddiPresentcb;

HRESULT PfnddxgiddiPresentcb(
  HANDLE hDevice,
  DXGIDDICB_PRESENT *unnamedParam2
)
{...}

Parameter

hDevice

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

unnamedParam2

[in] pPresentData ist ein Zeiger auf eine DXGIDDICB_PRESENT-Struktur , die die Quell- und Zielzuordnungen beschreibt, aus denen Inhalte kopiert werden.

Rückgabewert

pfnPresentCbDXGI gibt einen der folgenden Werte zurück:

Rückgabecode	Beschreibung
S_OK	Der Inhalt wurde erfolgreich kopiert.
E_OUTOFMEMORY	pfnPresentCbDXGI konnte aufgrund von unzureichendem Arbeitsspeicher nicht abgeschlossen werden.
E_INVALIDARG	Die Parameter wurden überprüft und als falsch ermittelt.

Hinweise

Der pDXGIContext-Member der DXGIDDICB_PRESENT Struktur, auf die der pPresentData-Parameter verweist, ist ein undurchsichtiger Kommunikationsmechanismus. Die Runtime übergibt diesen DXGI-Kontext an den Treiber im pDXGIContext-Member der DXGI_DDI_ARG_PRESENT-Struktur , wenn die Runtime die PresentDXGI-Funktion des Treibers aufruft. Der Treiber sollte diesen DXGI-Kontext unverändert in den pDXGIContext-Member von DXGIDDICB_PRESENT kopieren, wenn der Treiber pfnPresentCbDXGI aufruft.

Die Direct3D-Runtime schränkt den Satz von Formaten ein, die über einen Bitblockübertragungsvorgang (Bitblt) dargestellt werden können. Weitere Informationen zu den Einschränkungen finden Sie im Abschnitt Hinweise der BltDXGI-Referenzseite .