PFND3D11DDI_DESTROYCOMMANDLIST fonction de rappel (d3d10umddi.h)

  • Article

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 pour le périphérique d’affichage (contexte graphique).

unnamedParam2

hCommandList [in]

Handle pour les 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’il a précédemment allouée à la liste de commandes. Par conséquent, le pilote ne peut plus accéder à cette région de mémoire.

Valeur de retour

None

Remarques

Le pilote peut utiliser la fonction de rappel pfnSetErrorCb pour définir un code d’erreur.

Le pilote n’est requis pour implémenter DestroyCommandList que s’il prend en charge la fonctionnalité 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 rencontrer aucune erreur, à l’exception de D3DDDIERR_DEVICEREMOVED. Par conséquent, si le pilote réussit 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 le fonctionnement 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 DestroyCommandList et peut définir le membre pfnRecycleDestroyCommandList de la structure D3D11DDI_DEVICEFUNCS pour qu’il pointe 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 distinctes .

Pour plus d’informations sur RecycleDestroyCommandList, consultez Optimisation pour small command Listes.

Configuration requise

Condition requise Valeur
Client minimal pris en charge DestroyCommandList est pris en charge à partir du système d’exploitation Windows 7.
Plateforme cible Desktop (Expérience utilisateur)
En-tête d3d10umddi.h (incluez D3d10umddi.h)

Voir aussi

CreateCommandList

D3D11DDI_DEVICEFUNCS

D3D11DDI_THREADING_CAPS

GetCaps(D3D10_2)

pfnSetErrorCb