> ## 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 profondeur-gabarit.

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

## 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> (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](/fr-CA/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 de descripteurs à lier est déjà contigu en mémoire (il suffit alors d'un handle vers le premier). 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 à 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 de 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 à 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 les uns aux autres en mémoire.

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

Pointeur vers une structure [D3D12\_CPU\_DESCRIPTOR\_HANDLE](/fr-CA/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 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](/fr-CA/reference/graphics/d3d12_xs/interfaces/ID3D12GraphicsCommandList/id3d12graphicscommandlist_xs)


## Related topics

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