Passer au contenu principal
Modifie les tas de descripteurs actuellement liés qui sont associés à une liste de commandes.

Syntaxe

Paramètres

NumDescriptorHeaps
Type : UINT
Nombre de tas de descripteurs à lier. ppDescriptorHeaps
Type : [in] ID3D12DescriptorHeap*
Un pointeur vers un tableau d’objets ID3D12DescriptorHeap pour les tas à définir sur la liste de commandes. Vous pouvez seulement lier des tas de descripteurs de type D3D12_DESCRIPTOR_HEAP_TYPE_CBV_SRV_UAV et D3D12_DESCRIPTOR_HEAP_TYPE_SAMPLER. Un seul tas de descripteurs de chaque type peut être défini à la fois, ce qui signifie qu’un maximum de 2 tas (un échantillonneur, un CBV/SRV/UAV) peut être défini à la fois.

Valeur de retour

Type : void Aucune.

Remarques

SetDescriptorHeaps peut être appelée sur un bundle, mais les tas de descripteurs du bundle doivent correspondre au tas de descripteurs de la liste de commandes appelante. Pour plus d’informations sur les restrictions relatives aux bundles, consultez Creating and Recording Command Lists and Bundles. Tous les tas définis précédemment sont annulés par l’appel. Au plus un tas de chaque type visible par les nuanceurs peut être défini dans l’appel. La modification des tas de descripteurs peut entraîner un vidage du pipeline sur certains matériels. Pour cette raison, il est recommandé d’utiliser un seul tas visible par les nuanceurs de chaque type et de le définir une fois par image, plutôt que de modifier régulièrement les tas de descripteurs liés. Utilisez plutôt ID3D12Device::CopyDescriptors et ID3D12Device::CopyDescriptorsSimple pour copier les descripteurs requis des tas opaques pour les nuanceurs vers le tas unique visible par les nuanceurs, au besoin pendant le rendu.

Exemples

L’exemple D3D12Bundles utilise ID3D12GraphicsCommandList::SetDescriptorHeaps comme suit :
Consultez Example Code in the D3D12 Reference.

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

Tas de descripteurs ID3D12GraphicsCommandList
Dernière modification le 6 octobre 2026