> ## 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_DEPTH_STENCIL_OPTIONS_DESC (XBOX One 系列)

> 描述圖形管線狀態中的深度樣板設定。

描述圖形管線狀態中的深度樣板設定。

## 語法

```cpp theme={null}
typedef struct D3D12XBOX_DEPTH_STENCIL_OPTIONS_DESC {  
    BOOL BackFaceDisable;  
    BOOL DepthBoundsDisable;  
    BOOL ColorWritesOnDepthFailEnable;  
    BOOL ColorWritesOnDepthPassDisable;  
    UINT8 StencilReadMaskBack;  
    UINT8 StencilWriteMaskBack;  
    UINT8 StencilTestRefValueFront;  
    UINT8 StencilTestRefValueBack;  
    UINT8 StencilOpRefValueFront;  
    UINT8 StencilOpRefValueBack;  
} D3D12XBOX_DEPTH_STENCIL_OPTIONS_DESC  
```

### 成員

*BackFaceDisable*\
類型: BOOL

設定為 *true* 以針對表面法線背向相機的像素，停用深度測試和樣板測試結果的使用；否則為 *false*。

*DepthBoundsDisable*\
類型: BOOL

設定為 *true* 以停用深度界限；否則為 *false*。

*ColorWritesOnDepthFailEnable*\
類型: BOOL

設定為 *true* 以在深度偵測失敗時啟用色彩寫入；否則為 *false*。

*ColorWritesOnDepthPassDisable*\
類型: BOOL

設定為 *true* 以在深度通過時停用色彩寫入；否則為 *false*。

*StencilReadMaskBack*\
類型: UINT8

針對表面法線背向相機的像素啟用樣板讀取遮罩。

*StencilWriteMaskBack*\
類型: UINT8

針對表面法線背向相機的像素啟用樣板寫入遮罩。

*StencilTestRefValueFront*\
類型: UINT8

針對表面法線朝向相機的像素啟用樣板測試參考值。

*StencilTestRefValueBack*\
類型: UINT8

針對表面法線背向相機的像素啟用樣板測試參考值。

*StencilOpRefValueFront*\
類型: UINT8

針對表面法線朝向相機的像素啟用樣板作業參考值。

*StencilOpRefValueBack*\
類型: UINT8

針對表面法線背向相機的像素啟用樣板作業參考值。

## 備註

[D3D12XBOX\_DERIVED\_GRAPHICS\_STATE\_DESC](/zh-TW/reference/graphics/d3d12_x/structs/d3d12xbox_derived_graphics_state_desc) 和 [D3D12XBOX\_EXTENDED\_GRAPHICS\_PIPELINE\_STATE\_DESC](/zh-TW/reference/graphics/d3d12_x/structs/d3d12xbox_extended_graphics_pipeline_state_desc) 結構會使用此結構。

支援樣板的格式為 **DXGI\_FORMAT\_D24\_UNORM\_S8\_UINT** 和 **DXGI\_FORMAT\_D32\_FLOAT\_S8X24\_UINT**。

## 需求

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

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

## 另請參閱

[d3d12\_x](/zh-TW/reference/graphics/d3d12_x/d3d12_x_members)


## Related topics

- [NDA 主題目錄 - Microsoft Learn 線上連結](/zh-TW/nda/nda-topic-directory.md)
- [D3D12_DEPTH_STENCIL_DESC](/zh-CN/reference/graphics/d3d12/structs/d3d12_depth_stencil_desc_public.md)
- [D3D12_DEPTH_STENCIL_VIEW_DESC](/zh-CN/reference/graphics/d3d12/structs/d3d12_depth_stencil_view_desc_public.md)
- [D3D12_DEPTH_STENCILOP_DESC](/zh-CN/reference/graphics/d3d12/structs/d3d12_depth_stencilop_desc_public.md)
- [D3D12_RENDER_PASS_DEPTH_STENCIL_DESC](/zh-CN/reference/graphics/d3d12/structs/d3d12_render_pass_depth_stencil_desc_public.md)