PFND3D11DDI_DESTROYCOMMANDLIST fonction de rappel (d3d10umddi.h)
La fonction DestroyCommandList détruit une liste de commandes.
Syntaxe
PFND3D11DDI_DESTROYCOMMANDLIST Pfnd3d11ddiDestroycommandlist;
void Pfnd3d11ddiDestroycommandlist(
D3D10DDI_HDEVICE unnamedParam1,
D3D11DDI_HCOMMANDLIST unnamedParam2
)
{...}
Paramètres
unnamedParam1
hDevice [in]
Handle de l’appareil d’affichage (contexte graphique).
unnamedParam2
hCommandList [in]
Handle des données privées du pilote pour la liste de commandes à détruire. Le runtime Microsoft Direct3D libère la région de mémoire qu’elle a précédemment allouée pour la liste de commandes. Par conséquent, le pilote ne peut plus accéder à cette région de mémoire.
Valeur de retour
Aucun
Remarques
Le pilote peut utiliser la fonction de rappel pfnSetErrorCb pour définir un code d’erreur.
Le pilote est uniquement nécessaire pour implémenter DestroyCommandList si le pilote prend en charge la fonctionnalité de D3D11DDICAPS_COMMANDLISTS_BUILD_2 qui peut être retournée dans la structure D3D11DDI_THREADING_CAPS à partir d’un appel à la fonction GetCaps(D3D10_2).
Le pilote ne doit pas rencontrer d’erreur, à l’exception de D3DDDIERR_DEVICEREMOVED. Par conséquent, si le pilote transmet une erreur, à l’exception de D3DDDIERR_DEVICEREMOVED, dans un appel à la fonction pfnSetErrorCb, le runtime Direct3D détermine que l’erreur est critique. Même si l’appareil est supprimé, le pilote n’est pas tenu de retourner D3DDDIERR_DEVICEREMOVED ; toutefois, si la suppression de l’appareil interfère avec l’opération de DestroyCommandList (ce qui ne doit généralement pas se produire), le pilote peut retourner D3DDDIERR_DEVICEREMOVED.
Le pilote peut implémenter une fonction DestroyCommandList qui contient une instruction switch pour traiter la destruction des listes de commandes et la destruction légère des listes de commandes. Autrement dit, le pilote peut implémenter un DestroyCommandListet définir le membre pfnRecycleDestroyCommandList de la structure D3D11DDI_DEVICEFUNCS à pointer vers DestroyCommandList avec le membre pfnRecycleDestroyCommandList de D3D11DDI_DEVICEFUNCS pour pointer vers DestroyCommandList. Toutefois, pour améliorer les performances, le pilote peut implémenter des fonctions DestroyCommandList et RecycleDestroyCommandList.
Pour plus d’informations sur RecycleDestroyCommandList, consultez Optimisation pour les petites listes de commandes.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | DestroyCommandList est pris en charge à partir du système d’exploitation Windows 7. |
| plateforme cible | Bureau |
| d’en-tête | d3d10umddi.h (include D3d10umddi.h) |