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

> 此方法可讓您動態變更深度界限。

此方法可讓您動態變更深度界限。

## 語法

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

### 參數

*Min \[in]*\
類型：FLOAT

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

指定最小深度界限。預設值為 0。NaN 值會自動轉換為 0。

*Max \[in]*\
類型：FLOAT

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

指定最大深度界限。預設值為 1。NaN 值會自動轉換為 0。

### 傳回值

類型：void

無。

## 備註

深度界限測試可讓目前儲存的深度值超出 *Min* 與 *Max* (含) 所指定範圍時捨棄像素與樣本。如果像素或樣本目前儲存的深度值在此範圍內，則深度界限測試通過並進行轉譯；否則深度界限測試失敗，並捨棄該像素或樣本。請注意，深度界限測試考量的是目前儲存的深度值，而不是執行中的像素著色器所產生的深度值。

若要使用深度界限測試，應用程式必須使用新的 [CreatePipelineState](/zh-TW/reference/graphics/d3d12/interfaces/id3d12device2/methods/id3d12device2_createpipelinestate_public) 方法在 PSO 上啟用深度界限測試，然後即可使用此命令清單方法動態變更深度界限。

OMSetDepthBounds 是選用功能。請使用 [CheckFeatureSupport](/zh-TW/reference/graphics/d3d12/interfaces/id3d12device/methods/id3d12device_checkfeaturesupport_public) 方法判斷使用者模式驅動程式是否支援此功能。此功能的支援情況會透過 [D3D12\_FEATURE\_D3D12\_OPTIONS2](/zh-TW/reference/graphics/d3d12/enums/d3d12_feature_public) 結構回報。

## 需求

**標頭:** d3d12\_xs.h 或 d3d12\_x.h\
**程式庫:** d3d12\_xs.lib 或 d3d12\_x.lib\
**支援的平台**: XBOX Series 主機與 XBOX One 系列

## 另請參閱

[ID3D12GraphicsCommandList1](/zh-TW/reference/graphics/d3d12/interfaces/id3d12graphicscommandlist1/id3d12graphicscommandlist1_public)


## Related topics

- [D3D12_DEPTH_STENCIL_DESC1](/zh-TW/reference/graphics/d3d12/structs/d3d12_depth_stencil_desc1_public.md)
- [D3D12_FEATURE_DATA_D3D12_OPTIONS2](/zh-TW/reference/graphics/d3d12/structs/d3d12_feature_data_d3d12_options2_public.md)
- [GetBoundingBox](/zh-TW/reference/lighting/lamparray/interfaces/ilamparray/methods/ilamparray_getboundingbox.md)
- [CreateDepthStencilView](/zh-TW/reference/graphics/d3d12/interfaces/id3d12device/methods/id3d12device_createdepthstencilview_public.md)
- [D3D12_DEPTH_STENCIL_DESC](/zh-TW/reference/graphics/d3d12/structs/d3d12_depth_stencil_desc_public.md)