PFND3DDDI_PRESENTCB Rückruffunktion (d3dumddi.h)

Artikel
02/26/2024

Die pfnPresentCb-Funktion kopiert Inhalte aus einer Quellzuordnung.

Syntax

PFND3DDDI_PRESENTCB Pfnd3dddiPresentcb;

HRESULT Pfnd3dddiPresentcb(
  HANDLE hDevice,
  D3DDDICB_PRESENT *unnamedParam2
)
{...}

Parameter

hDevice

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

unnamedParam2

pData [in]

Ein Zeiger auf eine D3DDDICB_PRESENT Struktur, die die Quellzuordnung beschreibt, aus der Inhalte kopiert werden.

Rückgabewert

pfnPresentCb gibt einen der folgenden Werte zurück:

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

Diese Funktion kann auch andere HRESULT-Werte zurückgeben.

Hinweise

Der Benutzermodusanzeigetreiber legt das hContext-Element der D3DDDICB_PRESENT-Struktur fest, auf die vom pData-Parameter auf einen Kontext verwiesen wird, den er zuvor durch Aufrufen der PfnCreateContextCb-Funktion erstellt hat. Der Benutzermodusanzeigetreiber muss mindestens einen Kontext erstellen, wenn die Microsoft Direct3D-Runtime die CreateDevice - oder CreateDevice(D3D10) -Funktion des Treibers aufruft, um ein Gerät zu erstellen. Die Direct3D-Runtime sendet den vorliegenden Vorgang an einen erstellten Kontext.

Direct3D Version 11 Hinweis: Weitere Informationen dazu, wie der Treiber pfnPresentCb aufruft, finden Sie unter Änderungen von Direct3D 10.

Beispiele

Im folgenden Codebeispiel wird gezeigt, wie eine Zieloberfläche farbbefüllt wird.

    HRESULT hr=S_OK;
    // A color-fill request that does not have a source surface
    D3DDDICB_PRESENT    PresentCBData = {0};

    PresentCBData.hContext = m_sContexts[MULTI_ENGINE_NODE_3D].hContext;
    PresentCBData.hSrcAllocation = NULL;

    if (pPresent->hDstResource) {
        DWORD   dwDstSurf = ((DWORD)(DWORD_PTR)pPresent->hDstResource) + pPresent->DstSubResourceIndex;
        _ASSERT(dwDstSurf < m_RTbl.Size());
        m_RTbl[dwDstSurf].m_qwBatch = m_qwBatch;
        PresentCBData.hDstAllocation = R200GetSurfaceAllocHandle(m_pR200Ctx, dwDstSurf);
    }

    hr = m_d3dCallbacks.pfnPresentCb(m_hD3D, &PresentCBData);

    return hr;

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Verfügbar in Windows Vista und höheren Versionen der Windows-Betriebssysteme.
Zielplattform	Desktop
Kopfzeile	d3dumddi.h (include D3dumddi.h)