Syntaxe
Paramètres
pCommandList [in]Type : ID3D12GraphicsCommandList * Spécifie le ID3D12GraphicsCommandList qui détermine le bundle à exécuter.
Valeur de retour
Type : void Aucune.Notes
Les bundles héritent de tout l’état de la liste de commandes parente sur laquelle ExecuteBundle est appelée, à l’exception de l’objet d’état de pipeline et de la topologie de primitive. Tout l’état défini dans un bundle affecte l’état de la liste de commandes parente. Notez que ExecuteBundle n’est pas une opération prédiquée.Validation à l’exécution
Le runtime vérifie que l’« appelé » est un bundle et que l’« appelant » est une liste de commandes directe. Le runtime vérifie également que le bundle a été fermé. Si ce contrat n’est pas respecté, le runtime ignore l’appel sans le signaler. Un échec de validation entraîne le renvoi de E_INVALIDARG par Close.Couche de débogage
La couche de débogage émet un avertissement dans les mêmes cas où le runtime échoue. La couche de débogage émet un avertissement si un prédicat est défini lorsque ExecuteCommandList est appelée. En outre, la couche de débogage émet une erreur si elle détecte qu’une ressource référencée par la liste de commandes a été détruite. La couche de débogage vérifie également que l’allocateur de commandes associé au bundle n’a pas été réinitialisé depuis l’appel de Close sur la liste de commandes. Cette validation a lieu au moment de l’appel à ExecuteBundle et lorsque la liste de commandes parente est exécutée sur une file d’attente de commandes.Exemples
L’exemple D3D12Bundles utilise ID3D12GraphicsCommandList::ExecuteBundle comme suit :Configuration requise
En-tête : d3d12_xs.h ou d3d12_x.hBibliothèque : d3d12_xs.lib ou d3d12_x.lib
Plateformes prises en charge : consoles XBOX Series et famille XBOX One
