ID3D12GraphicsCommandList ::OMSetRenderTargets, méthode (d3d12.h)

Définit les handles de descripteur de processeur pour les cibles de rendu et le gabarit de profondeur.

Syntaxe

void OMSetRenderTargets(
  [in]           UINT                              NumRenderTargetDescriptors,
  [in, optional] const D3D12_CPU_DESCRIPTOR_HANDLE *pRenderTargetDescriptors,
  [in]           BOOL                              RTsSingleHandleToDescriptorRange,
  [in, optional] const D3D12_CPU_DESCRIPTOR_HANDLE *pDepthStencilDescriptor
);

Paramètres

[in] NumRenderTargetDescriptors

Type : UINT

Nombre d’entrées dans le tableau pRenderTargetDescriptors (compris 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 dans ce paramètre.

[in, optional] pRenderTargetDescriptors

Type : const D3D12_CPU_DESCRIPTOR_HANDLE*

Spécifie un tableau de structures D3D12_CPU_DESCRIPTOR_HANDLE qui décrivent les handles de descripteur de processeur qui représentent le début du tas de descripteurs cibles de rendu. Si ce paramètre a la valeur NULL et Que NumRenderTargetDescriptors a la valeur 0, aucune cible de rendu n’est liée.

[in] RTsSingleHandleToDescriptorRange

Type : BOOL

True signifie que le handle transmis est le pointeur vers une plage contiguë de descripteurs NumRenderTargetDescriptors . Ce cas est utile si l’ensemble de descripteurs à lier est déjà contigu en mémoire (il suffit donc d’un handle au premier). Par exemple, si NumRenderTargetDescriptors a la valeur 3, la disposition de la mémoire est prise comme suit :

Dans ce cas, le pilote déréférence le handle, puis incrémente la mémoire vers laquelle il pointe.

False signifie que le handle est le premier d’un tableau de handles NumRenderTargetDescriptors . La casse false permet à une application de lier un ensemble de descripteurs à partir de différents emplacements à la fois. Là encore, en supposant que NumRenderTargetDescriptors a la valeur 3, la disposition de la mémoire est prise comme suit :

Dans ce cas, le pilote déréférence trois handles qui sont censés être adjacents les uns aux autres en mémoire.

[in, optional] pDepthStencilDescriptor

Type : const D3D12_CPU_DESCRIPTOR_HANDLE*

Pointeur vers une structure de D3D12_CPU_DESCRIPTOR_HANDLE qui décrit le descripteur de processeur qui représente le début du tas qui contient le descripteur de gabarit de profondeur. Si ce paramètre a la valeur NULL, aucun descripteur de gabarit de profondeur n’est lié.

Valeur de retour

None

Configuration requise

Condition requise	Valeur
Plateforme cible	Windows
En-tête	d3d12.h
Bibliothèque	D3d12.lib
DLL	D3d12.dll

Voir aussi

ID3D12GraphicsCommandList