PFND3DDDI_DESTROYCONTEXTCB Rückruffunktion (d3dumddi.h)

  • Artikel

Die PfnDestroyContextCb-Funktion zerstört den Kontext, der durch einen Aufruf der PfnCreateContextCb-Funktion erstellt wurde.

Syntax

PFND3DDDI_DESTROYCONTEXTCB Pfnd3dddiDestroycontextcb;

HRESULT Pfnd3dddiDestroycontextcb(
  HANDLE hDevice,
  const D3DDDICB_DESTROYCONTEXT *unnamedParam2
)
{...}

Parameter

hDevice

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

unnamedParam2

pData [in]

Ein Zeiger auf eine D3DDDICB_DESTROYCONTEXT Struktur, die ein Handle für den zu zerstörenden Kontext enthält.

Rückgabewert

pfnDestroyContextCb gibt einen der folgenden Werte zurück:

Rückgabecode Beschreibung
S_OK Der Kontext wurde erfolgreich zerstört.
E_INVALIDARG Parameter wurden überprüft und als falsch ermittelt.

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

Hinweise

Wenn der angegebene Kontext die Arbeit, die sich derzeit in der Warteschlange befindet, nicht abgeschlossen hat, blockiert die PfnDestroyContextCb-Funktion , bis der Kontext seine Arbeit beendet und dann zurückgibt.

pfnDestroyContextCb gibt einen Fehler zurück, wenn der zu zerstörende Kontext derzeit ein Synchronisierungsobjekt besitzt.

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

Das folgende Codebeispiel zeigt, wie der Standardkontext für ein Anzeigegerät zerstört wird.

    if (m_d3dCallbacks.pfnDestroyContextCb) {
        D3DDDICB_DESTROYCONTEXT DestroyContext;
        DestroyContext.hContext = m_sContexts[MULTI_ENGINE_NODE_3D].hContext;
        m_d3dCallbacks.pfnDestroyContextCb(m_hD3D, &DestroyContext);
        m_sContexts[MULTI_ENGINE_NODE_3D].hContext = NULL;
    }

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)

Weitere Informationen

D3DDDICB_DESTROYCONTEXT

pfnCreateContextCb