LPD3DHAL_CONTEXTDESTROYCB Rückruffunktion (d3dhal.h)

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

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.

Anforderungen

Siehe auch

D3DHAL_CONTEXTCREATEDATA

D3DHAL_CONTEXTDESTROYDATA

D3dContextCreate

D3dDestroyDLocal-

DD_DIRECTDRAW_LOCAL