PFND3DDDI_DESTROYRESOURCE Rückruffunktion (d3dumddi.h)

Artikel
02/26/2024

Die DestroyResource-Funktion gibt eine angegebene Ressource frei.

Syntax

PFND3DDDI_DESTROYRESOURCE Pfnd3dddiDestroyresource;

HRESULT Pfnd3dddiDestroyresource(
  HANDLE hDevice,
  HANDLE unnamedParam2
)
{...}

Parameter

hDevice

Ein Handle für das Anzeigegerät (Grafikkontext), das zum Zerstören der Ressource verwendet wird.

unnamedParam2

hResource [in]

Ein Handle für die Ressource, die von der CreateResource - oder OpenResource-Funktion erstellt wurde.

Rückgabewert

DestroyResource gibt S_OK oder ein entsprechendes Fehlerergebnis zurück, wenn die Ressource nicht freigegeben wird.

Hinweise

Nachdem die Microsoft Direct3D-Runtime die DestroyResource-Funktion des Benutzermodusanzeigetreibers aufgerufen hat, muss der Benutzermodusanzeigetreiber zunächst alle Batchbefehle leeren, die von der Ressource abhängen, die durch Aufrufen der funktion pfnRenderCb der Runtime zerstört wird. Der Treiber muss dann die Funktion pfnDeallocateCb der Runtime aufrufen, um Zuordnungen zu zerstören, die der Ressource zugeordnet sind.

Hinweis Die DestroyResource-Funktion des Treibers ist nicht erforderlich, um pfnDeallocateCb vor der Rückgabe aufzurufen. Stattdessen kann der Treiber die Zuordnungsvernichtung zurückstellen.

Hinweis Ein separater DestroyResource-Aufruf wird nicht für jede Oberfläche durchgeführt, die Teil der Ressource ist. Wenn also eine Gruppe von Oberflächen atomar erstellt wird, wird die Gruppe immer auch atomisch zerstört.

Weitere Informationen zum Erstellen und Zerstören von Ressourcen finden Sie unter Behandeln von Ressourcenerstellung und -zerstörung.

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