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

> D3D12XBOX_SAMPLER_DESC (XBOX One 系列主機) — 描述取樣器狀態。適用於 XBOX 遊戲開發的 Direct3D 12 圖形 API 參考。

描述取樣器狀態。

## 語法

```cpp theme={null}
typedef struct D3D12XBOX_SAMPLER_DESC {  
    D3D12XBOX_SAMPLER_FLAGS Flags;  
    D3D12XBOX_TEXTURE_XY_FILTER FilterMag;  
    D3D12XBOX_TEXTURE_XY_FILTER FilterMin;  
    D3D12XBOX_TEXTURE_MIP_FILTER FilterMip;  
    D3D12XBOX_TEXTURE_Z_FILTER FilterZ;  
    D3D12XBOX_TEXTURE_FILTER_MODE FilterMode;  
    D3D12_TEXTURE_ADDRESS_MODE AddressU;  
    D3D12_TEXTURE_ADDRESS_MODE AddressV;  
    D3D12_TEXTURE_ADDRESS_MODE AddressW;  
    FLOAT MinLOD;  
    FLOAT MaxLOD;  
    FLOAT MipLODBias;  
    FLOAT MipLODBiasSecondary;  
    UINT MaxAnisotropy;  
    FLOAT AnisotropyBias;  
    UINT AnisotropyThreshold;  
    D3D12_COMPARISON_FUNC ComparisonFunc;  
    FLOAT BorderColor[4];  
    UINT PerformanceMip;  
    UINT PerformanceZ;  
} D3D12XBOX_SAMPLER_DESC  
```

### 成員

*Flags*\
類型: [D3D12XBOX\_SAMPLER\_FLAGS](/zh-TW/reference/graphics/d3d12_x/enums/d3d12xbox_sampler_flags)

**D3D12XBOX\_SAMPLER\_FLAGS** 列舉中的旗標。

*FilterMag*\
類型: [D3D12XBOX\_TEXTURE\_XY\_FILTER](/zh-TW/reference/graphics/d3d12_x/enums/d3d12xbox_texture_xy_filter)

**D3D12XBOX\_TEXTURE\_XY\_FILTER** 列舉中的這個值會指定要使用的 XY 篩選。

*FilterMin*\
類型: [D3D12XBOX\_TEXTURE\_XY\_FILTER](/zh-TW/reference/graphics/d3d12_x/enums/d3d12xbox_texture_xy_filter)

**D3D12XBOX\_TEXTURE\_XY\_FILTER** 列舉中的這個值會指定要使用的 XY 篩選。

*FilterMip*\
類型: [D3D12XBOX\_TEXTURE\_MIP\_FILTER](/zh-TW/reference/graphics/d3d12_x/enums/d3d12xbox_texture_mip_filter)

**D3D12XBOX\_TEXTURE\_MIP\_FILTER** 列舉中的這個值會指定要使用的 MIP 篩選。

*FilterZ*\
類型: [D3D12XBOX\_TEXTURE\_Z\_FILTER](/zh-TW/reference/graphics/d3d12_x/enums/d3d12xbox_texture_z_filter)

**D3D12XBOX\_TEXTURE\_Z\_FILTER** 列舉中的這個值會指定要使用的 Z 篩選。

*FilterMode*\
類型: [D3D12XBOX\_TEXTURE\_FILTER\_MODE](/zh-TW/reference/graphics/d3d12_x/enums/d3d12xbox_texture_filter_mode)

**D3D12XBOX\_TEXTURE\_FILTER\_MODE** 列舉中的這個值會指定取樣紋理時要使用的篩選方法。

*AddressU*\
類型: [D3D12\_TEXTURE\_ADDRESS\_MODE](/zh-TW/reference/graphics/d3d12_x/enums/d3d12_texture_address_mode)

**D3D12\_TEXTURE\_ADDRESS\_MODE** 列舉中的這個值會指定用來解析超出 0-1 範圍之 u 紋理座標的方法。

*AddressV*\
類型: [D3D12\_TEXTURE\_ADDRESS\_MODE](/zh-TW/reference/graphics/d3d12_x/enums/d3d12_texture_address_mode)

**D3D12\_TEXTURE\_ADDRESS\_MODE** 列舉中的這個值會指定用來解析超出 0-1 範圍之 v 紋理座標的方法。

*AddressW*\
類型: [D3D12\_TEXTURE\_ADDRESS\_MODE](/zh-TW/reference/graphics/d3d12_x/enums/d3d12_texture_address_mode)

**D3D12\_TEXTURE\_ADDRESS\_MODE** 列舉中的這個值會指定用來解析超出 0-1 範圍之 w 紋理座標的方法。

*MinLOD*\
類型: FLOAT

要限制存取之 mipmap 範圍的下限。0 是最大且最詳細的 mipmap 層級，任何高於此值的層級都較不詳細。

*MaxLOD*\
類型: FLOAT

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

*MipLODBias*\
類型: FLOAT

與計算出之 mipmap 層級的位移。例如，如果執行階段計算指出紋理要在 mipmap 層級 3 取樣，且 MipLODBias 為 2，則紋理會在 mipmap 層級 5 取樣。

*MipLODBiasSecondary*\
類型: FLOAT

與計算出之 mipmap 層級的次要位移。

*MaxAnisotropy*\
類型: UINT

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

*AnisotropyBias*\
類型: FLOAT

為了降低計算出的非等向性，會從計算出的非等向性比率中減去這個 u1.5 欄位。減法在對數空間中進行，因此 1.0 會將非等向性比率和取樣數目減半。值越大，為了效能而犧牲的品質就越多。Anisobias 可依據每個資源的 PERF\_MOD 欄位，以個別資源為基礎進行縮減。final\_aniso\_degree 為 2^(aniso\_degree\_exp - AnisotropicBias)。使用此偏差的最大縮減量接近 4。

*AnisotropyThreshold*\
類型: UINT

調整紋理取樣硬體中與非等向性篩選相關的效能與品質取捨。值越大，效能越高，但取樣品質越低。

*ComparisonFunc*\
類型: [D3D12\_COMPARISON\_FUNC](https://msdn.microsoft.com/library/dn770349\(v=vs.85\).aspx)

D3D12\_COMPARISON\_FUNC 類型的值，指定將取樣資料與現有取樣資料進行比較的函式。

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

當 **AddressU**、**AddressV** 或 **AddressW** 指定 **D3D12\_TEXTURE\_ADDRESS\_MODE\_BORDER** 時所使用的框線色彩。範圍必須介於 0.0-1.0 (含)。

*PerformanceMip*\
類型: UINT

調整紋理取樣硬體中與 MIP 篩選相關的效能與品質取捨。值越大，效能越高，但取樣品質越低。

*PerformanceZ*\
類型: 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_SAMPLER_DESC](/zh-CN/reference/graphics/d3d12/structs/d3d12_sampler_desc_public.md)
- [D3D12_STATIC_SAMPLER_DESC](/zh-CN/reference/graphics/d3d12/structs/d3d12_static_sampler_desc_public.md)
- [NDA topic directory - live Microsoft Learn links](/nda/nda-topic-directory.md)
- [Diretório de tópicos NDA: links ativos do Microsoft Learn](/pt-BR/nda/nda-topic-directory.md)