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

# OMSetDepthBounds

> Este método permite alterar os limites de profundidade dinamicamente.

Este método permite alterar os limites de profundidade dinamicamente.

## Sintaxe

```cpp theme={null}
void OMSetDepthBounds(
    FLOAT Min,
    FLOAT Max
)
```

### Parâmetros

*Min \[in]*\
Tipo: FLOAT

[SAL](https://learn.microsoft.com/en-us/visualstudio/code-quality/annotating-function-parameters-and-return-values): <code>*In*</code>

Especifica o limite mínimo de profundidade. O valor padrão é 0. Valores NaN são convertidos silenciosamente para 0.

*Max \[in]*\
Tipo: FLOAT

[SAL](https://learn.microsoft.com/en-us/visualstudio/code-quality/annotating-function-parameters-and-return-values): <code>*In*</code>

Especifica o limite máximo de profundidade. O valor padrão é 1. Valores NaN são convertidos silenciosamente para 0.

### Valor retornado

Tipo: void

Nenhum.

## Comentários

O teste de limites de profundidade permite que pixels e amostras sejam descartados se o valor de profundidade armazenado no momento estiver fora do intervalo especificado por <i>Min</i> e <i>Max</i>, inclusive. Se o valor de profundidade armazenado no momento do pixel ou da amostra estiver dentro desse intervalo, o teste de limites de profundidade será aprovado e ele será renderizado; caso contrário, o teste de limites de profundidade falhará e o pixel ou a amostra será descartado. Observe que o teste de limites de profundidade considera o valor de profundidade armazenado no momento, e não o valor de profundidade gerado pelo pixel shader em execução.

Para usar o teste de limites de profundidade, o aplicativo deve usar o novo método [CreatePipelineState](/pt-BR/reference/graphics/d3d12/interfaces/id3d12device2/methods/id3d12device2_createpipelinestate_public) para habilitar o teste de limites de profundidade no PSO e, em seguida, pode usar este método da lista de comandos para alterar os limites de profundidade dinamicamente.

OMSetDepthBounds é um recurso opcional. Use o método [CheckFeatureSupport](/pt-BR/reference/graphics/d3d12/interfaces/id3d12device/methods/id3d12device_checkfeaturesupport_public) para determinar se esse recurso tem suporte do driver de modo de usuário. O suporte a esse recurso é informado por meio da estrutura [D3D12\_FEATURE\_D3D12\_OPTIONS2](/pt-BR/reference/graphics/d3d12/enums/d3d12_feature_public).

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

[ID3D12GraphicsCommandList1](/pt-BR/reference/graphics/d3d12/interfaces/id3d12graphicscommandlist1/id3d12graphicscommandlist1_public)


## Related topics

- [D3D12_DEPTH_STENCIL_DESC1](/pt-BR/reference/graphics/d3d12/structs/d3d12_depth_stencil_desc1_public.md)
- [D3D12_FEATURE_DATA_D3D12_OPTIONS2](/pt-BR/reference/graphics/d3d12/structs/d3d12_feature_data_d3d12_options2_public.md)
- [CreateDepthStencilView](/pt-BR/reference/graphics/d3d12/interfaces/id3d12device/methods/id3d12device_createdepthstencilview_public.md)
- [D3D12_DEPTH_STENCIL_DESC](/pt-BR/reference/graphics/d3d12/structs/d3d12_depth_stencil_desc_public.md)
- [D3D12_DEPTH_WRITE_MASK](/pt-BR/reference/graphics/d3d12/enums/d3d12_depth_write_mask_public.md)
