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 |