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

# BeginRenderPass (consoles XBOX Series)

> Marca o início de uma passagem de renderização associando um conjunto de recursos de saída durante a passagem de renderização. Essas associações são para um ou mais.

Marca o início de uma passagem de renderização associando um conjunto de recursos de saída durante a passagem de renderização. Essas associações são para uma ou mais exibições de destino de renderização (RTVs) e/ou para uma exibição de profundidade/estêncil (DSV).

## Sintaxe

```cpp theme={null}
void BeginRenderPass(
    UINT NumRenderTargets,
    const D3D12_RENDER_PASS_RENDER_TARGET_DESC  pRenderTargets,
    const D3D12_RENDER_PASS_DEPTH_STENCIL_DESC  pDepthStencil,
    D3D12_RENDER_PASS_FLAGS Flags
)
```

### Parâmetros

*NumRenderTargets*\
Tipo: UINT

Um **UINT**. O número de destinos de renderização que estão sendo associados.

*pRenderTargets*\
Tipo: const D3D12\_RENDER\_PASS\_RENDER\_TARGET\_DESC \*

Um ponteiro para uma constante [D3D12\_RENDER\_PASS\_RENDER\_TARGET\_DESC](/pt-BR/reference/graphics/d3d12/structs/d3d12_render_pass_render_target_desc_public), que descreve as associações (fixas durante a passagem de renderização) a uma ou mais exibições de destino de renderização (RTVs), bem como suas características de acesso inicial e final.

*pDepthStencil*\
Tipo: const D3D12\_RENDER\_PASS\_DEPTH\_STENCIL\_DESC \*

Um ponteiro para uma constante [D3D12\_RENDER\_PASS\_DEPTH\_STENCIL\_DESC](/pt-BR/reference/graphics/d3d12/structs/d3d12_render_pass_depth_stencil_desc_public), que descreve uma associação (fixa durante a passagem de renderização) a uma exibição de profundidade/estêncil (DSV), bem como suas características de acesso inicial e final.

*Flags*\
Tipo: D3D12\_RENDER\_PASS\_FLAGS

Um [D3D12\_RENDER\_PASS\_FLAGS](/pt-BR/reference/graphics/d3d12/enums/d3d12_render_pass_flags_public). A natureza/os requisitos da passagem de renderização; por exemplo, se é uma passagem de renderização em suspensão ou em retomada, ou se ela deseja gravar em exibições de acesso não ordenado.

### Valor retornado

Tipo: void

Nenhum.

## Requisitos

**Cabeçalho:** d3d12\_xs.h\
**Biblioteca:** d3d12\_xs.lib\
**Plataformas com suporte**: consoles XBOX Series

## Confira também

[EndRenderPass](/pt-BR/reference/graphics/d3d12/interfaces/id3d12graphicscommandlist4/methods/id3d12graphicscommandlist4_endrenderpass_public)

[ID3D12GraphicsCommandList4](/pt-BR/reference/graphics/d3d12_xs/interfaces/ID3D12GraphicsCommandList4/id3d12graphicscommandlist4)

[Renderização](https://learn.microsoft.com/en-us/windows/win32/direct3d12/rendering)


## Related topics

- [EndRenderPass (consoles XBOX Series)](/pt-BR/reference/graphics/d3d12/interfaces/id3d12graphicscommandlist4/methods/id3d12graphicscommandlist4_endrenderpass_public.md)
- [D3D12_RENDER_PASS_FLAGS (consoles XBOX Series)](/pt-BR/reference/graphics/d3d12/enums/d3d12_render_pass_flags_public.md)
- [D3D12_RENDER_PASS_BEGINNING_ACCESS](/pt-BR/reference/graphics/d3d12/structs/d3d12_render_pass_beginning_access_public.md)
- [D3D12_RENDER_PASS_BEGINNING_ACCESS_TYPE](/pt-BR/reference/graphics/d3d12/enums/d3d12_render_pass_beginning_access_type_public.md)
- [D3D12_RENDER_PASS_BEGINNING_ACCESS_CLEAR_PARAMETERS](/pt-BR/reference/graphics/d3d12/structs/d3d12_render_pass_beginning_access_clear_parameters_public.md)