LPD3DHAL_CONTEXTDESTROYCB Rückruffunktion (d3dhal.h)

Artikel
02/06/2025

Die D3dContextDestroy--Funktion löscht den angegebenen Kontext.

Syntax

LPD3DHAL_CONTEXTDESTROYCB Lpd3dhalContextdestroycb;

DWORD Lpd3dhalContextdestroycb(
  LPD3DHAL_CONTEXTDESTROYDATA unnamedParam1
)
{...}

Parameter

unnamedParam1

pcdd [in]

Verweist auf eine D3DHAL_CONTEXTDESTROYDATA Struktur, die die informationen enthält, die für den Treiber erforderlich sind, um den Kontext zu zerstören.

Rückgabewert

D3dContextDestroy gibt einen der folgenden Rückrufcodes zurück:

Bemerkungen

Alle Microsoft Direct3D-Treiber müssen D3dContextDestroy-unterstützen.

Der Treiber sollte alle Ressourcen freigeben, die dem zu löschenden Kontext zugeordnet sind. Beispielsweise sollte der Treiber die folgenden Ressourcen freigeben, die dem Kontext zugeordnet sind:

Texturressourcen
Vertex- und Pixelshader-
Deklarationen und Code für Vertex-Shader
Ressourcen für asynchrone Abfragen

Der Treiber sollte die dem Kontext zugeordneten Microsoft DirectDraw-Oberflächen nicht freigeben, da diese von DirectDraw als Reaktion auf eine Anwendungs- oder Direct3D-Laufzeitanforderung freigegeben werden.

Wenn der Treiber den Zeiger auf die DD_DIRECTDRAW_LOCAL Struktur zwischengespeichert hat, die als lpDLcl Member der D3DHAL_CONTEXTCREATEDATA-Struktur übergeben wurde, wenn D3dContextCreate aufgerufen wurde, wird der Zeiger möglicherweise ungültig, bevor D3dContextDestroy- aufgerufen wird. Daher darf D3dContextDestroy- diesen DD_DIRECTDRAW_LOCAL Zeiger nicht ableiten, da eine Zugriffsverletzung zu einem Ergebnis oder zufälligen Daten führen kann. Wenn beispielsweise die D3dDestroyDLocal-Funktion des Treibers vor D3dContextDestroy-aufgerufen wird, gibt das Betriebssystem diesen DD_DIRECTDRAW_LOCAL Zeiger vor dem D3dContextDestroy Aufruf frei.

D3dContextDestroy- kann mit deaktiviertem PDEV-aufgerufen werden. Ein PDEV ist durch Aufrufen der DrvAssertMode--Funktion des Anzeigetreibers deaktiviert oder aktiviert. Weitere Informationen finden Sie unter Managing PDEVs.