PFND3DDDI_DESTROYCONTEXTCB Rückruffunktion (d3dumddi.h)
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) |