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

# OMSetRenderTargets

> Define identificadores de descritor de CPU para os destinos de renderização e o estêncil de profundidade.

Define identificadores de descritor de CPU para os destinos de renderização e o estêncil de profundidade.

## Sintaxe

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

### Parâmetros

*NumRenderTargetDescriptors \[in]*\
Tipo: UINT

O número de entradas na matriz *pRenderTargetDescriptors* (varia entre 0 e **D3D12\_SIMULTANEOUS\_RENDER\_TARGET\_COUNT**). Se esse parâmetro for diferente de zero, o número de entradas na matriz para a qual pRenderTargetDescriptors aponta deverá ser igual ao número nesse parâmetro.

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

Especifica uma matriz de estruturas [D3D12\_CPU\_DESCRIPTOR\_HANDLE](https://docs.xbox.com/pt-BR/reference/graphics/d3d12/structs/d3d12_cpu_descriptor_handle_public.md) que descrevem os identificadores de descritor de CPU que representam o início do heap de descritores de destino de renderização. Se esse parâmetro for NULL e NumRenderTargetDescriptors for 0, nenhum destino de renderização será associado.

*RTsSingleHandleToDescriptorRange \[in]*\
Tipo: BOOL

**True** significa que o identificador passado é o ponteiro para um intervalo contíguo de *NumRenderTargetDescriptors* descritores. Esse caso é útil se o conjunto de descritores a ser associado já estiver contíguo na memória (de modo que basta um identificador para o primeiro). Por exemplo, se *NumRenderTargetDescriptors* for 3, o layout de memória será interpretado da seguinte maneira:

![Layout de memória com o parâmetro definido como true](https://mintcdn.com/microsoft-4404708b/5IpvKlT-jmAaVkeY/images/nda/graphics/oms_true.png?fit=max\&auto=format\&n=5IpvKlT-jmAaVkeY\&q=85\&s=ca9a65f296f515512968ef8e99ddb20e)

Nesse caso, o driver desreferencia o identificador e, em seguida, incrementa a memória apontada.

**False** significa que o identificador é o primeiro de uma matriz de *NumRenderTargetDescriptors* identificadores. O caso false permite que um aplicativo associe de uma só vez um conjunto de descritores de locais diferentes. Novamente supondo que *NumRenderTargetDescriptors* seja 3, o layout de memória será interpretado da seguinte maneira:

![Layout de memória com o parâmetro definido como false](https://mintcdn.com/microsoft-4404708b/5IpvKlT-jmAaVkeY/images/nda/graphics/oms_false.png?fit=max\&auto=format\&n=5IpvKlT-jmAaVkeY\&q=85\&s=c88e0ec402d2cb0c624ed18ccc174c42)

Nesse caso, o driver desreferencia três identificadores que devem estar adjacentes entre si na memória.

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

Um ponteiro para uma estrutura [D3D12\_CPU\_DESCRIPTOR\_HANDLE](https://docs.xbox.com/pt-BR/reference/graphics/d3d12/structs/d3d12_cpu_descriptor_handle_public.md) que descreve o identificador de descritor de CPU que representa o início do heap que contém o descritor de estêncil de profundidade. Se esse parâmetro for NULL, nenhum descritor de estêncil de profundidade será associado.

### Valor retornado

Tipo: void

Nenhum.

## Requisitos

**Cabeçalho:** d3d12\_xs.h ou d3d12\_x.h\
**Biblioteca:** d3d12\_xs.lib ou d3d12\_x.lib\
**Plataformas com suporte**: consoles XBOX Series e família XBOX One

## Confira também

[ID3D12GraphicsCommandList](https://docs.xbox.com/pt-BR/reference/graphics/d3d12_xs/interfaces/ID3D12GraphicsCommandList/id3d12graphicscommandlist_xs.md)


## Related topics

- [D3D12_CPU_DESCRIPTOR_HANDLE](https://docs.xbox.com/pt-BR/reference/graphics/d3d12/structs/d3d12_cpu_descriptor_handle_public.md)
- [set_audio_render_volume](https://docs.xbox.com/pt-BR/reference/chat/gamechat2/classes/chat_user/chat_user_local/methods/chat_user_local_set_audio_render_volume.md)
- [CreateRenderTargetView](https://docs.xbox.com/pt-BR/reference/graphics/d3d12/interfaces/id3d12device/methods/id3d12device_createrendertargetview_public.md)
- [D3D12_RENDER_PASS_RENDER_TARGET_DESC](https://docs.xbox.com/pt-BR/reference/graphics/d3d12/structs/d3d12_render_pass_render_target_desc_public.md)
- [PartyLocalChatControl::SetAudioRenderVolume](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/networking/reference/classes/PartyLocalChatControl/methods/partylocalchatcontrol_setaudiorendervolume.md)