PFND3D11DDI_DESTROYCOMMANDLIST funzione di callback (d3d10umddi.h)
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. 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 il pfnSetErrorCb funzione di callback per impostare un codice di errore.
Il driver è necessario solo per implementare DestroyCommandList se il driver supporta la funzionalità di 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 alcun errore, 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 il funzionamento di DestroyCommandList (che in genere non dovrebbe accadere), 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. Ovvero, il driver può implementare un DestroyCommandListe può impostare il pfnRecycleDestroyCommandList membro della struttura D3D11DDI_DEVICEFUNCS in modo che punti a DestroyCommandList insieme al pfnRecycleDestroyCommandList membro di D3D11DDI_DEVICEFUNCS che punti a DestroyCommandList. Tuttavia, per migliorare le prestazioni, il driver può implementare funzioni DestroyCommandList e RecycleDestroyCommandList.
Per altre informazioni su RecycleDestroyCommandList, vedere Ottimizzazione per elenchi di comandi di piccole dimensioni.
Fabbisogno
| Requisito | Valore |
|---|---|
| client minimo supportato | DestroyCommandList è supportato a partire dal sistema operativo Windows 7. |
| piattaforma di destinazione | Desktop |
| intestazione | d3d10umddi.h (include D3d10umddi.h) |