Skip to main content
Crée une liste de commandes.

Syntaxe

Paramètres

pDesc _In_
Type : D3D12XBOX_COMMAND_LIST_DESC*
La description de la liste de commandes à créer. pCommandAllocator _In_
Type : ID3D12CommandAllocator*
Pointeur vers l’objet ID3D12CommandAllocator à partir duquel l’appareil crée des listes de commandes. pInitialState _In_opt_
Type : ID3D12PipelineState*
Pointeur vers l’objet ID3D12PipelineState qui contient l’état de pipeline initial de la liste de commandes. Ce paramètre est facultatif et peut être défini sur NULL. S’il est défini sur NULL, le runtime définit un état de pipeline initial factice afin que les pilotes rencontrent un état non défini. La surcharge associée est faible, en particulier pour une liste de commandes, pour laquelle le coût global de l’enregistrement de la liste de commandes est bien supérieur à celui de la définition de l’état initial. Par conséquent, s’il n’est pas pratique de définir le paramètre d’état de pipeline initial, ne pas le définir coûte peu. riid
Type : REFIID
L’identificateur global unique (GUID) de l’interface de liste de commandes. Pour récupérer le REFIID (ou GUID) de l’interface de l’état de pipeline, utilisez la macro __uuidof(). Par exemple, pour obtenir le GUID de l’interface d’une liste de commandes, procédez comme suit :
ppCommandList _Outptr_
Type : void**
Pointeur vers un bloc de mémoire qui reçoit un pointeur vers l’interface ID3D12CommandList ou ID3D12GraphicsCommandList de la liste de commandes.

Valeur de retour

Type : HRESULT Cette méthode retourne E_OUTOFMEMORY si la mémoire est insuffisante pour créer la liste de commandes. Pour les autres valeurs de retour possibles, consultez Codes de retour Direct3D 12.

Remarques

L’appareil crée des listes de commandes à partir de l’allocateur de commandes. Pour plus d’informations sur les allocateurs de commandes, consultez CreateCommandAllocator et Création et enregistrement de listes de commandes et de paquets. Pour plus d’informations sur la création de listes de commandes, consultez CreateCommandList.

Configuration requise

En-tête : d3d12_x.h Bibliothèque : d3d12_x.lib Plateformes prises en charge : famille XBOX One

Voir aussi

ID3D12Device
Last modified on October 6, 2026