Passer au contenu principal
Définit les handles de descripteur processeur pour les cibles de rendu et le profondeur-gabarit.

Syntaxe

Paramètres

NumRenderTargetDescriptors [in]
Type : UINT
Nombre d’entrées dans le tableau pRenderTargetDescriptors (entre 0 et D3D12_SIMULTANEOUS_RENDER_TARGET_COUNT). Si ce paramètre est différent de zéro, le nombre d’entrées dans le tableau vers lequel pointe pRenderTargetDescriptors doit être égal au nombre indiqué dans ce paramètre. pRenderTargetDescriptors [in, optional]
Type : const D3D12_CPU_DESCRIPTOR_HANDLE *
Spécifie un tableau de structures D3D12_CPU_DESCRIPTOR_HANDLE qui décrivent les handles de descripteur processeur représentant le début du tas de descripteurs de cibles de rendu. Si ce paramètre est NULL et que NumRenderTargetDescriptors est 0, aucune cible de rendu n’est liée. RTsSingleHandleToDescriptorRange [in]
Type : BOOL
True signifie que le handle transmis est le pointeur vers une plage contiguë de NumRenderTargetDescriptors descripteurs. Ce cas est utile si l’ensemble de descripteurs à lier est déjà contigu en mémoire (il suffit alors d’un handle vers le premier). Par exemple, si NumRenderTargetDescriptors vaut 3, la disposition de la mémoire est interprétée comme suit : Disposition de la mémoire avec le paramètre défini à true Dans ce cas, le pilote déréférence le handle, puis incrémente la mémoire pointée. False signifie que le handle est le premier d’un tableau de NumRenderTargetDescriptors handles. Le cas false permet à une application de lier en une seule fois un ensemble de descripteurs provenant d’emplacements différents. En supposant de nouveau que NumRenderTargetDescriptors vaut 3, la disposition de la mémoire est interprétée comme suit : Disposition de la mémoire avec le paramètre défini à false Dans ce cas, le pilote déréférence trois handles censés être adjacents les uns aux autres en mémoire. pDepthStencilDescriptor [in, optional]
Type : const D3D12_CPU_DESCRIPTOR_HANDLE *
Pointeur vers une structure D3D12_CPU_DESCRIPTOR_HANDLE qui décrit le handle de descripteur processeur représentant le début du tas qui contient le descripteur de profondeur-gabarit. Si ce paramètre est NULL, aucun descripteur de profondeur-gabarit n’est lié.

Valeur de retour

Type : void Aucune.

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

ID3D12GraphicsCommandList
Dernière modification le 6 octobre 2026