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

# D3D12XBOX_PIXEL_SHADER_OPTION_EXEC_ON_HIER_FAIL

> Fornece configurações para o registro DB_SHADER_CONTROL.EXEC_ON_HIER_FAIL, para controlar o teste de profundidade do sombreador de pixel.

Fornece configurações para o registro **DB\_SHADER\_CONTROL.EXEC\_ON\_HIER\_FAIL**, para controlar o teste de profundidade do sombreador de pixel.

## Sintaxe

```cpp theme={null}
typedef enum D3D12XBOX_PIXEL_SHADER_OPTION_EXEC_ON_HIER_FAIL
{  
    D3D12XBOX_PIXEL_SHADER_OPTION_EXEC_ON_HIER_FAIL_DEFAULT = 0,  
    D3D12XBOX_PIXEL_SHADER_OPTION_EXEC_ON_HIER_FAIL_ENABLE = 1,  
    D3D12XBOX_PIXEL_SHADER_OPTION_EXEC_ON_HIER_FAIL_DISABLE = 2  
} D3D12XBOX_PIXEL_SHADER_OPTION_EXEC_ON_HIER_FAIL  
```

## Constantes

| Constante | Descrição |
| - | - |
| D3D12XBOX\_PIXEL\_SHADER\_OPTION\_EXEC\_ON\_HIER\_FAIL\_DEFAULT | Usa as configurações definidas pelo sombreador de pixel atual. |
| D3D12XBOX\_PIXEL\_SHADER\_OPTION\_EXEC\_ON\_HIER\_FAIL\_ENABLE | O sombreador é executado mesmo que os testes de Z hierárquico ou de estêncil hierárquico descartem o quad que está sendo testado. |
| D3D12XBOX\_PIXEL\_SHADER\_OPTION\_EXEC\_ON\_HIER\_FAIL\_DISABLE | O sombreador não é executado se os testes de Z hierárquico ou de estêncil hierárquico descartarem o quad que está sendo testado. |

## Comentários

[D3D12XBOX\_PIXEL\_SHADER\_OPTIONS\_DESC](/pt-BR/reference/graphics/d3d12_x/structs/d3d12xbox_pixel_shader_options_desc) usa esta enumeração.

Use essas configurações para quaisquer amostras que falhem ou passem (DEPTH\_BEFORE\_SHADER=0) quando o sombreador de pixel tiver um efeito colateral desejado não coberto pelos outros sinalizadores de sombreador de pixel.

As eliminações de EarlyZ e ReZ ainda impedirão a execução do sombreador.

## Requisitos

**Cabeçalho:** d3d12\_x.h

**Plataformas com suporte:** família XBOX One

## Confira também

[d3d12\_x](/pt-BR/reference/graphics/d3d12_x/d3d12_x_members)\
[XboxSetPixelShaderOptions](/pt-BR/reference/graphics/d3d12_x/interfaces/cd3dx12xbox_pipeline_state_stream_parse_helper/methods/cd3dx12xbox_pipeline_state_stream_parse_helper_xboxsetpixelshaderoptions)


## Related topics

- [Diretório de tópicos NDA: links ativos do Microsoft Learn](/pt-BR/nda/nda-topic-directory.md)
- [D3D12_SHADER_VISIBILITY](/pt-BR/reference/graphics/d3d12/enums/d3d12_shader_visibility_public.md)
- [D3D12_BLEND_OP](/pt-BR/reference/graphics/d3d12/enums/d3d12_blend_op_public.md)
- [D3D12_FEATURE_DATA_D3D12_OPTIONS](/pt-BR/reference/graphics/d3d12/structs/d3d12_feature_data_d3d12_options_public.md)
- [D3D12_BLEND](/pt-BR/reference/graphics/d3d12/enums/d3d12_blend_public.md)