PFND3DDDI_DESTROYRESOURCE funzione di callback (d3dumddi.h)

Articolo
02/06/2025

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 definitivamente la risorsa.

unnamedParam2

hResource [in]

Handle per la risorsa creata dalla funzione CreateResource o OpenResource.

Valore restituito

DestroyResource restituisce S_OK o un risultato di errore appropriato indica che la risorsa non viene rilasciata.

Osservazioni

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

Nota La funzione di destroyresource del driver non è necessaria per chiamare pfnDeallocateCb prima di tornare; Il driver può invece rinviare la distruzione dell'allocazione.

Nota Non viene eseguita una chiamata destroyResource separata per ogni superficie che fa parte della risorsa. Quindi, se un gruppo di superfici viene creato in modo atomico, il gruppo viene sempre distrutto in modo atomico.

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

Fabbisogno

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)

Vedere anche

Condividi tramite