PFND3DDDI_DESTROYRESOURCE funzione di callback (d3dumddi.h)

Articolo
02/26/2024

La funzione DestroyResource rilascia una risorsa specificata.

Sintassi

PFND3DDDI_DESTROYRESOURCE Pfnd3dddiDestroyresource;

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

Parametri

hDevice

Handle per il dispositivo di visualizzazione (contesto grafico) usato per eliminare la risorsa.

unnamedParam2

hResource [in]

Handle alla risorsa creata dalla funzione CreateResource o OpenResource .

Valore restituito

DestroyResource restituisce S_OK o un risultato di errore appropriato è la risorsa non rilasciata.

Commenti

Dopo che il runtime di Microsoft Direct3D chiama la funzione del driver di visualizzazione in modalità utente DestroyResource , il driver di visualizzazione in modalità utente deve prima scaricare tutti i comandi batch che dipendono dalla risorsa che viene eliminata chiamando la funzione pfnRenderCb del runtime. Il driver deve quindi chiamare la funzione pfnDeallocateCb del runtime per eliminare le allocazioni associate alla risorsa.

Nota La funzione DestroyResource del driver non è necessaria per chiamare pfnDeallocateCb prima di restituire; invece, il driver può rinviare la distruzione dell'allocazione.

Nota Una chiamata DestroyResource separata non viene eseguita per ogni superficie che fa parte della risorsa. Quindi, se un gruppo di superfici viene creato atomicamente, il gruppo viene sempre distrutto atomicamente.

Per altre informazioni sulla creazione e l'eliminazione delle risorse, vedere Gestione della creazione e della distruzione delle risorse.

Requisiti

Requisito	Valore
Client minimo supportato	Disponibile in Windows Vista e versioni successive dei sistemi operativi Windows.
Piattaforma di destinazione	Desktop
Intestazione	d3dumddi.h (include D3dumddi.h)

Vedi anche