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

> Establece identificadores de descriptor de CPU para los destinos de representación y la galería de símbolos de profundidad.

Establece identificadores de descriptor de CPU para los destinos de representación y la galería de símbolos de profundidad.

## Sintaxis

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

El número de entradas de la matriz <i>pRenderTargetDescriptors</i> (con valores entre 0 y **D3D12\_SIMULTANEOUS\_RENDER\_TARGET\_COUNT**). Si este parámetro no es cero, el número de entradas de la matriz a la que apunta pRenderTargetDescriptors debe ser igual al número indicado en este parámetro.

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

Especifica una matriz de estructuras [D3D12\_CPU\_DESCRIPTOR\_HANDLE](/reference/graphics/d3d12/structs/d3d12_cpu_descriptor_handle_public) que describen los identificadores de descriptor de CPU que representan el inicio del montón de descriptores de destino de representación. Si este parámetro es NULL y NumRenderTargetDescriptors es 0, no se enlaza ningún destino de representación.

*RTsSingleHandleToDescriptorRange \[in]*\
Tipo: BOOL

**True** significa que el identificador que se pasa es el puntero a un intervalo contiguo de <i>NumRenderTargetDescriptors</i> descriptores.  Este caso resulta útil si el conjunto de descriptores que se van a enlazar ya es contiguo en memoria (de modo que solo se necesita un identificador al primero de ellos).  Por ejemplo, si <i>NumRenderTargetDescriptors</i> es 3, el diseño de memoria se interpreta de la siguiente manera:

<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="Diseño de memoria con el parámetro establecido en true" width="221" height="147" data-path="images/nda/graphics/oms_true.png" />

En este caso, el controlador desreferencia el identificador y, a continuación, incrementa la memoria a la que apunta.

**False** significa que el identificador es el primero de una matriz de <i>NumRenderTargetDescriptors</i> identificadores.  El caso false permite que una aplicación enlace un conjunto de descriptores de distintas ubicaciones a la vez. De nuevo, suponiendo que <i>NumRenderTargetDescriptors</i> es 3, el diseño de memoria se interpreta de la siguiente manera:

<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="Diseño de memoria con el parámetro establecido en false" width="228" height="222" data-path="images/nda/graphics/oms_false.png" />

En este caso, el controlador desreferencia tres identificadores que se espera que sean adyacentes entre sí en memoria.

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

Un puntero a una estructura [D3D12\_CPU\_DESCRIPTOR\_HANDLE](/reference/graphics/d3d12/structs/d3d12_cpu_descriptor_handle_public) que describe el identificador de descriptor de CPU que representa el inicio del montón que contiene el descriptor de galería de símbolos de profundidad. Si este parámetro es NULL, no se enlaza ningún descriptor de galería de símbolos de profundidad.

### Valor devuelto

Tipo: void

Ninguno.

## Requisitos

**Encabezado:** d3d12\_xs.h o d3d12\_x.h\
**Biblioteca:** d3d12\_xs.lib o d3d12\_x.lib\
**Plataformas compatibles**: consolas XBOX Series y familia XBOX One

## Consulte también

[ID3D12GraphicsCommandList](/reference/graphics/d3d12_xs/interfaces/ID3D12GraphicsCommandList/id3d12graphicscommandlist_xs)


## Related topics

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