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

# D3D12_SAMPLER_DESC

> 描述取樣器狀態。(D3D12_SAMPLER_DESC)

描述取樣器狀態。

## 語法

```cpp theme={null}
typedef struct D3D12_SAMPLER_DESC
{
    D3D12_FILTER Filter;
    D3D12_TEXTURE_ADDRESS_MODE AddressU;
    D3D12_TEXTURE_ADDRESS_MODE AddressV;
    D3D12_TEXTURE_ADDRESS_MODE AddressW;
    FLOAT MipLODBias;
    UINT MaxAnisotropy;
    D3D12_COMPARISON_FUNC ComparisonFunc;
    FLOAT BorderColor;
    FLOAT MinLOD;
    FLOAT MaxLOD;
} D3D12_SAMPLER_DESC
```

### 成員

*Filter*\
類型：D3D12\_FILTER

[D3D12\_FILTER](/zh-TW/reference/graphics/d3d12/enums/d3d12_filter_public) 類型的值，指定取樣紋理時要使用的篩選方法。

*AddressU*\
類型：D3D12\_TEXTURE\_ADDRESS\_MODE

[D3D12\_TEXTURE\_ADDRESS\_MODE](/zh-TW/reference/graphics/d3d12_x/enums/d3d12_texture_address_mode) 類型的值，指定解析超出 0 到 1 範圍之 u 紋理座標時要使用的方法。

*AddressV*\
類型：D3D12\_TEXTURE\_ADDRESS\_MODE

[D3D12\_TEXTURE\_ADDRESS\_MODE](/zh-TW/reference/graphics/d3d12_x/enums/d3d12_texture_address_mode) 類型的值，指定解析超出 0 到 1 範圍之 v 紋理座標時要使用的方法。

*AddressW*\
類型：D3D12\_TEXTURE\_ADDRESS\_MODE

[D3D12\_TEXTURE\_ADDRESS\_MODE](/zh-TW/reference/graphics/d3d12_x/enums/d3d12_texture_address_mode) 類型的值，指定解析超出 0 到 1 範圍之 w 紋理座標時要使用的方法。

*MipLODBias*\
類型：FLOAT

與計算出之 MIP 對應層級的位移。例如，如果執行階段計算出應在 MIP 對應層級 3 取樣紋理，而 **MipLODBias** 為 2，則會在 MIP 對應層級 5 取樣紋理。

*MaxAnisotropy*\
類型：UINT

在 **Filter** 中指定 **D3D12\_FILTER\_ANISOTROPIC** 或 **D3D12\_FILTER\_COMPARISON\_ANISOTROPIC** 時使用的限制值。有效值介於 1 到 16 之間。

*ComparisonFunc*\
類型：D3D12\_COMPARISON\_FUNC

[D3D12\_COMPARISON\_FUNC](/zh-TW/reference/graphics/d3d12/enums/d3d12_comparison_func_public) 類型的值，指定將取樣資料與現有取樣資料進行比較的函式。

*BorderColor*\
類型：FLOAT\[4]

為 **AddressU**、**AddressV** 或 **AddressW** 指定 [D3D12\_TEXTURE\_ADDRESS\_MODE\_BORDER](/zh-TW/reference/graphics/d3d12_x/enums/d3d12_texture_address_mode) 時要使用的 RGBA 框線色彩。範圍必須介於 0.0 到 1.0 (含) 之間。

*MinLOD*\
類型：FLOAT

限制存取之 MIP 對應範圍的下限，其中 0 是最大且最詳細的 MIP 對應層級，任何高於此值的層級細節都較少。

*MaxLOD*\
類型：FLOAT

限制存取之 MIP 對應範圍的上限，其中 0 是最大且最詳細的 MIP 對應層級，任何高於此值的層級細節都較少。此值必須大於或等於 **MinLOD**。若不要對 LOD 設定上限，請將此成員設定為較大的值。

## 備註

此結構由 [CreateSampler](/zh-TW/reference/graphics/d3d12/interfaces/id3d12device/methods/id3d12device_createsampler_public) 使用。

## 需求

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

## 另請參閱

[核心結構](https://learn.microsoft.com/en-us/windows/desktop/direct3d12/direct3d-12-structures)


## Related topics

- [CreateSampler](/zh-TW/reference/graphics/d3d12/interfaces/id3d12device/methods/id3d12device_createsampler_public.md)
- [D3D12_FILTER_TYPE](/zh-TW/reference/graphics/d3d12/enums/d3d12_filter_type_public.md)
- [D3D12_FILTER_REDUCTION_TYPE](/zh-TW/reference/graphics/d3d12/enums/d3d12_filter_reduction_type_public.md)
- [D3D12_COMPARISON_FUNC](/zh-TW/reference/graphics/d3d12/enums/d3d12_comparison_func_public.md)
- [D3D12_FILTER](/zh-TW/reference/graphics/d3d12/enums/d3d12_filter_public.md)