Partager via


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 :

Disposition de la mémoire avec le paramètre défini sur true 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 :

Disposition de la mémoire avec paramètre défini sur false 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