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

> 提供 DB_SHADER_CONTROL.EXEC_ON_HIER_FAIL 暫存器的設定，以控制像素著色器深度測試。

提供 **DB\_SHADER\_CONTROL.EXEC\_ON\_HIER\_FAIL** 暫存器的設定，以控制像素著色器深度測試。

## 語法

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

## 常數

| 常數 | 描述 |
| - | - |
| D3D12XBOX\_PIXEL\_SHADER\_OPTION\_EXEC\_ON\_HIER\_FAIL\_DEFAULT | 使用目前像素著色器定義的設定。 |
| D3D12XBOX\_PIXEL\_SHADER\_OPTION\_EXEC\_ON\_HIER\_FAIL\_ENABLE | 即使階層式 Z 或階層式樣板測試會捨棄正在測試的四邊形，著色器仍會執行。 |
| D3D12XBOX\_PIXEL\_SHADER\_OPTION\_EXEC\_ON\_HIER\_FAIL\_DISABLE | 如果階層式 Z 或階層式樣板測試會捨棄正在測試的四邊形，著色器就不會執行。 |

## 備註

[D3D12XBOX\_PIXEL\_SHADER\_OPTIONS\_DESC](/zh-TW/reference/graphics/d3d12_x/structs/d3d12xbox_pixel_shader_options_desc) 使用此列舉。

當像素著色器具有其他像素著色器旗標未涵蓋的預期副作用時，請對任何失敗或通過的樣本 (DEPTH\_BEFORE\_SHADER=0) 使用這些設定。

EarlyZ 和 ReZ 終止仍會使著色器停止執行。

## 需求

**標頭：** d3d12\_x.h

**支援的平台：** XBOX One 系列

## 另請參閱

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


## Related topics

- [NDA topic directory - live Microsoft Learn links](/nda/nda-topic-directory.md)
- [Répertoire des rubriques NDA : liens actifs vers Microsoft Learn](/fr/nda/nda-topic-directory.md)
- [Diretório de tópicos NDA: links ativos do Microsoft Learn](/pt-BR/nda/nda-topic-directory.md)
- [Directorio de temas NDA: enlaces activos a Microsoft Learn](/es/nda/nda-topic-directory.md)
- [NDA 主題目錄 - Microsoft Learn 線上連結](/zh-TW/nda/nda-topic-directory.md)