> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# OMSetRenderTargets

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

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

## Syntaxe

```cpp theme={null}
void OMSetRenderTargets(
    UINT NumRenderTargetDescriptors,
    const D3D12_CPU_DESCRIPTOR_HANDLE  pRenderTargetDescriptors,
    BOOL RTsSingleHandleToDescriptorRange,
    const D3D12_CPU_DESCRIPTOR_HANDLE  pDepthStencilDescriptor
)
```

### Paramètres

*NumRenderTargetDescriptors \[in]*\
Type : UINT

Nombre d'entrées dans le tableau <i>pRenderTargetDescriptors</i> (compris entre 0 et **D3D12\_SIMULTANEOUS\_RENDER\_TARGET\_COUNT**). Si ce paramètre est différent de zéro, le nombre d'entrées du tableau vers lequel pointe pRenderTargetDescriptors doit être égal à la valeur de ce paramètre.

*pRenderTargetDescriptors \[in, optional]*\
Type : const D3D12\_CPU\_DESCRIPTOR\_HANDLE \*

Spécifie un tableau de structures [D3D12\_CPU\_DESCRIPTOR\_HANDLE](/fr/reference/graphics/d3d12/structs/d3d12_cpu_descriptor_handle_public) 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 <i>NumRenderTargetDescriptors</i> descripteurs. Ce cas est utile si l'ensemble des descripteurs à lier se trouve déjà être contigu en mémoire (seul un handle vers le premier est alors nécessaire). Par exemple, si <i>NumRenderTargetDescriptors</i> vaut 3, la disposition de la mémoire est interprétée comme suit :

<img src="https://mintcdn.com/microsoft-4404708b/5IpvKlT-jmAaVkeY/images/nda/graphics/oms_true.png?fit=max&auto=format&n=5IpvKlT-jmAaVkeY&q=85&s=ca9a65f296f515512968ef8e99ddb20e" alt="Disposition de la mémoire avec le paramètre défini sur true" width="221" height="147" data-path="images/nda/graphics/oms_true.png" />

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 <i>NumRenderTargetDescriptors</i> handles. Le cas false permet à une application de lier en une seule fois un ensemble de descripteurs provenant d'emplacements différents. En supposant à nouveau que <i>NumRenderTargetDescriptors</i> vaut 3, la disposition de la mémoire est interprétée comme suit :

<img src="https://mintcdn.com/microsoft-4404708b/5IpvKlT-jmAaVkeY/images/nda/graphics/oms_false.png?fit=max&auto=format&n=5IpvKlT-jmAaVkeY&q=85&s=c88e0ec402d2cb0c624ed18ccc174c42" alt="Disposition de la mémoire avec le paramètre défini sur false" width="228" height="222" data-path="images/nda/graphics/oms_false.png" />

Dans ce cas, le pilote déréférence trois handles censés être adjacents en mémoire.

*pDepthStencilDescriptor \[in, optional]*\
Type : const D3D12\_CPU\_DESCRIPTOR\_HANDLE \*

Pointeur vers une structure [D3D12\_CPU\_DESCRIPTOR\_HANDLE](/fr/reference/graphics/d3d12/structs/d3d12_cpu_descriptor_handle_public) qui décrit le handle de descripteur processeur représentant le début du tas qui contient le descripteur de stencil de profondeur. Si ce paramètre est NULL, aucun descripteur de stencil de profondeur 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](/fr/reference/graphics/d3d12_xs/interfaces/ID3D12GraphicsCommandList/id3d12graphicscommandlist_xs)


## Related topics

- [D3D12_CPU_DESCRIPTOR_HANDLE](/fr/reference/graphics/d3d12/structs/d3d12_cpu_descriptor_handle_public.md)
- [CreateRenderTargetView](/fr/reference/graphics/d3d12/interfaces/id3d12device/methods/id3d12device_createrendertargetview_public.md)
- [D3D12_RENDER_PASS_RENDER_TARGET_DESC](/fr/reference/graphics/d3d12/structs/d3d12_render_pass_render_target_desc_public.md)
- [PartyLocalChatControl::SetAudioRenderVolume](/fr/services/playfab/multiplayer/networking/reference/classes/PartyLocalChatControl/methods/partylocalchatcontrol_setaudiorendervolume.md)
- [D3D12_RENDER_TARGET_BLEND_DESC](/fr/reference/graphics/d3d12/structs/d3d12_render_target_blend_desc_public.md)