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

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

提供 **DB\_SHADER\_CONTROL.DEPTH\_BEFORE\_SHADER** 暫存器的設定，以控制像素著色器深度測試的時機。

## 語法

```cpp theme={null}
typedef enum D3D12XBOX_PIXEL_SHADER_OPTION_DEPTH_BEFORE_SHADER
{  
    D3D12XBOX_PIXEL_SHADER_OPTION_DEPTH_BEFORE_SHADER_DEFAULT = 0,  
    D3D12XBOX_PIXEL_SHADER_OPTION_DEPTH_BEFORE_SHADER_ENABLE = 1,  
    D3D12XBOX_PIXEL_SHADER_OPTION_DEPTH_BEFORE_SHADER_DISABLE = 2  
} D3D12XBOX_PIXEL_SHADER_OPTION_DEPTH_BEFORE_SHADER  
```

## 常數

| 常數 | 描述 |
| - | - |
| D3D12XBOX\_PIXEL\_SHADER\_OPTION\_DEPTH\_BEFORE\_SHADER\_DEFAULT | 使用目前像素著色器定義的設定。 |
| D3D12XBOX\_PIXEL\_SHADER\_OPTION\_DEPTH\_BEFORE\_SHADER\_ENABLE | 在像素著色器執行之前執行深度檢查。 |
| D3D12XBOX\_PIXEL\_SHADER\_OPTION\_DEPTH\_BEFORE\_SHADER\_DISABLE | 在像素著色器執行之後執行深度檢查。 |

## 備註

`D3D12XBOX_PIXEL_SHADER_OPTION_DEPTH_BEFORE_SHADER` 提供 **DB\_SHADER\_CONTROL.DEPTH\_BEFORE\_SHADER** 暫存器的設定，以控制像素著色器深度測試的時機。

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

根據預設，著色器會在深度處理之後執行。在此模式中：

* 會防止著色器終止樣本。
* 會防止像素處理 (Alpha 測試、Alpha 至涵蓋範圍、涵蓋範圍至遮罩、遮罩匯出，以及 Z/樣板匯出) 影響深度作業。
* 會防止著色器和像素處理不允許 EarlyZ。
* ZPass 計數會在 Z 測試之後計算；以著色器和 Alpha 為基礎的剔除不再減少 ZPass 計數。

## 需求

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

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

## 另請參閱

[CreateGraphicsPipelineStateX](/zh-TW/reference/graphics/d3d12_x/interfaces/id3d12device/methods/id3d12device_creategraphicspipelinestatex)\
[CreateDerivedGraphicsPipelineStateX](/zh-TW/reference/graphics/d3d12_x/interfaces/id3d12device/methods/id3d12device_createderivedgraphicspipelinestatex)\
[d3d12\_x](/zh-TW/reference/graphics/d3d12_x/d3d12_x_members)


## 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-CN/nda/nda-topic-directory.md)