> ## 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

> 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 <i>pRenderTargetDescriptors</i> (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](/pt-BR/reference/graphics/d3d12/structs/d3d12_cpu_descriptor_handle_public) 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 <i>NumRenderTargetDescriptors</i> 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 <i>NumRenderTargetDescriptors</i> for 3, o layout de memória será interpretado da seguinte maneira:

<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="Layout de memória com o parâmetro definido como true" width="221" height="147" data-path="images/nda/graphics/oms_true.png" />

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 <i>NumRenderTargetDescriptors</i> identificadores. O caso false permite que um aplicativo associe de uma só vez um conjunto de descritores de locais diferentes. Novamente supondo que <i>NumRenderTargetDescriptors</i> seja 3, o layout de memória será interpretado da seguinte maneira:

<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="Layout de memória com o parâmetro definido como false" width="228" height="222" data-path="images/nda/graphics/oms_false.png" />

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](/pt-BR/reference/graphics/d3d12/structs/d3d12_cpu_descriptor_handle_public) 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](/pt-BR/reference/graphics/d3d12_xs/interfaces/ID3D12GraphicsCommandList/id3d12graphicscommandlist_xs)


## Related topics

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