CreateCommandList

Crée une liste de commandes.

Syntaxe

HRESULT CreateCommandList(
    UINT nodeMask,
    D3D12_COMMAND_LIST_TYPE type,
    ID3D12CommandAllocator  pCommandAllocator,
    ID3D12PipelineState  pInitialState,
    const IID & riid,
    void  ppCommandList
)

Paramètres

nodeMask [in]
Type : UINT Pour un fonctionnement à un seul GPU, définissez cette valeur à zéro. S’il y a plusieurs nœuds GPU, définissez un bit pour identifier le nœud (l’adaptateur physique du périphérique) pour lequel créer la liste de commandes. Chaque bit du masque correspond à un seul nœud. Un seul bit doit être défini. Consultez également Systèmes multiadaptateurs. type [in]
Type : D3D12_COMMAND_LIST_TYPE Spécifie le type de liste de commandes à créer. pCommandAllocator [in]
Type : ID3D12CommandAllocator * Un pointeur vers l’objet allocateur de commandes à partir duquel le périphérique crée des listes de commandes. pInitialState [in, optional]
Type : ID3D12PipelineState * Un pointeur facultatif vers l’objet d’état de pipeline qui contient l’état de pipeline initial de la liste de commandes. S’il vaut nullptr, le runtime définit un état de pipeline initial factice, afin que les pilotes n’aient pas à gérer un état non défini. La surcharge associée est faible, en particulier pour une liste de commandes, dont le coût global d’enregistrement éclipse probablement le coût d’un seul paramètre d’état initial. Il y a donc peu de coût à ne pas définir le paramètre d’état de pipeline initial, si cela n’est pas pratique. Pour les bundles, en revanche, il peut être plus judicieux d’essayer de définir le paramètre d’état initial (puisque les bundles sont probablement plus petits dans l’ensemble et peuvent être réutilisés fréquemment). riid [in]
Type : const IID & Une référence à l’identificateur global unique (GUID) de l’interface de liste de commandes à retourner dans ppCommandList. ppCommandList [out]
Type : void ** Un 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 Si la fonction réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT.

Valeur de retour	Description
E_OUTOFMEMORY	La mémoire est insuffisante pour créer la liste de commandes.

Consultez les codes de retour Direct3D 12 pour connaître les autres valeurs de retour possibles.

Remarques

Le périphérique crée des listes de commandes à partir de l’allocateur de commandes.

Exemples

L’exemple D3D12Bundles utilise ID3D12Device::CreateCommandList comme suit. Créez les objets de pipeline.

ComPtr<ID3D12CommandAllocator> m_commandAllocator;
ComPtr<ID3D12GraphicsCommandList> m_commandList;

Créez un allocateur de commandes.

ThrowIfFailed(m_device->CreateCommandAllocator(D3D12_COMMAND_LIST_TYPE_DIRECT, IID_PPV_ARGS(&m_commandAllocator)));

Création de la liste de commandes directe.

ThrowIfFailed(m_device->CreateCommandList(0, D3D12_COMMAND_LIST_TYPE_DIRECT, m_commandAllocator.Get(), nullptr, IID_PPV_ARGS(&m_commandList)));

Consultez l’exemple de code dans la référence D3D12.

Configuration requise

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

Voir aussi

ID3D12Device ID3D12GraphicsCommandList::Reset

(all) API references

Error codes

Audio API reference

Chat API reference

Developer kit only API reference

Graphics API reference

Input API reference

Lighting API reference

Networking API reference

XBOX PC remote iteration API reference

System API reference

Tools API reference

Windows device portal REST API reference

XBOX services API reference

MicrosoftGame.config reference

Syntaxe

Paramètres

Valeur de retour

Remarques

Exemples

Configuration requise

Voir aussi

​Syntaxe

​Paramètres

​Valeur de retour

​Remarques

​Exemples

​Configuration requise

​Voir aussi

Syntaxe

Paramètres

Valeur de retour

Remarques

Exemples

Configuration requise

Voir aussi