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

Syntaxe

Paramètres

pDesc _In_
Type : D3D12XBOX_COMMAND_LIST_DESC*
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 ne rencontrent pas d’état non défini. La surcharge est faible, en particulier pour une liste de commandes, dont le coût global d’enregistrement 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 n’entraîne qu’un faible coût. riid
Type : REFIID
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 renvoyée

Type : HRESULT Cette méthode renvoie E_OUTOFMEMORY si la mémoire est insuffisante pour créer la liste de commandes. Pour les autres valeurs de retour possibles, reportez-vous aux 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 bundles. 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