PFND3D11DDI_DESTROYCOMMANDLIST funzione di callback (d3d10umddi.h)

Articolo
02/25/2024

La funzione DestroyCommandList elimina definitivamente un elenco di comandi.

Sintassi

PFND3D11DDI_DESTROYCOMMANDLIST Pfnd3d11ddiDestroycommandlist;

void Pfnd3d11ddiDestroycommandlist(
  D3D10DDI_HDEVICE unnamedParam1,
  D3D11DDI_HCOMMANDLIST unnamedParam2
)
{...}

Parametri

unnamedParam1

hDevice [in]

Handle per il dispositivo di visualizzazione (contesto grafico).

unnamedParam2

hCommandList [in]

Handle per i dati privati del driver per l'elenco di comandi da eliminare definitivamente. Il runtime di Microsoft Direct3D libera l'area di memoria allocata in precedenza per l'elenco di comandi. Pertanto, il driver non può più accedere a questa area di memoria.

Valore restituito

nessuno

Osservazioni

Il driver può usare la funzione di callback pfnSetErrorCb per impostare un codice di errore.

Il driver è necessario solo per implementare DestroyCommandList se il driver supporta la funzionalità D3D11DDICAPS_COMMANDLISTS_BUILD_2 che può essere restituita nella struttura D3D11DDI_THREADING_CAPS da una chiamata alla funzione GetCaps(D3D10_2).

Il driver non deve riscontrare errori, ad eccezione di D3DDDIERR_DEVICEREMOVED. Pertanto, se il driver passa qualsiasi errore, ad eccezione di D3DDDIERR_DEVICEREMOVED, in una chiamata alla funzione pfnSetErrorCb , il runtime Direct3D determina che l'errore è critico. Anche se il dispositivo viene rimosso, il driver non è necessario per restituire D3DDDIERR_DEVICEREMOVED; Tuttavia, se la rimozione del dispositivo interferisce con l'operazione di DestroyCommandList (che in genere non dovrebbe verificarsi), il driver può restituire D3DDDIERR_DEVICEREMOVED.

Il driver può implementare una funzione DestroyCommandList che contiene un'istruzione switch per elaborare la distruzione degli elenchi di comandi e la leggera distruzione degli elenchi di comandi. In altre parole, il driver può implementare un oggetto DestroyCommandList e può impostare il membro pfnRecycleDestroyCommandList della struttura D3D11DDI_DEVICEFUNCS in modo che punti a DestroyCommandList insieme al membro pfnRecycleDestroyCommandList di D3D11DDI_DEVICEFUNCS in modo che punti a DestroyCommandList. Tuttavia, per migliorare le prestazioni, il driver può implementare funzioni DestroyCommandList e RecycleDestroyCommandList separate.

Per altre informazioni su RecycleDestroyCommandList, vedere Optimization for Small Command Elenchi.For more information about RecycleDestroyCommandList, see Optimization for Small Command Elenchi.

Requisiti

Requisito	Valore
Client minimo supportato	DestroyCommandList è supportato a partire dal sistema operativo Windows 7.
Piattaforma di destinazione	Desktop
Intestazione	d3d10umddi.h (include D3d10umddi.h)