> ## 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 Series 主機)

> D3D12XBOX_SAMPLER_DESC (XBOX Series 主機) — 描述取樣器狀態。適用於 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_MINMIP_FILTER_SLOPE MinMipSlopeU;  
    D3D12XBOX_MINMIP_FILTER_OFFSET MinMipOffsetU;  
    D3D12XBOX_MINMIP_FILTER_SLOPE MinMipSlopeVOrW;  
    D3D12XBOX_MINMIP_FILTER_OFFSET MinMipOffsetVOrW;  
} D3D12XBOX_SAMPLER_DESC  
```

### 成員

*Flags*\
類型：[D3D12XBOX\_SAMPLER\_FLAGS](/zh-TW/reference/graphics/d3d12_xs/enums/d3d12xbox_sampler_flags_xs)

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

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

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

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

*PerformanceMip*\
類型：UINT

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

*PerformanceZ*\
類型：UINT

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

*MinMipSlopeU*\
類型：[D3D12XBOX\_MINMIP\_FILTER\_SLOPE](/zh-TW/reference/graphics/d3d12_xs/enums/d3d12xbox_minmip_filter_slope)

定義 MinMip 雙線性篩選在 U 方向的斜率。斜率越大，篩選外觀越銳利。針對 3D minmip 對應進行篩選時，此值也會套用至 V 方向。

*MinMipOffsetU*\
類型：[D3D12XBOX\_MINMIP\_FILTER\_OFFSET](/zh-TW/reference/graphics/d3d12_xs/enums/d3d12xbox_minmip_filter_offset)

定義 MinMip 雙線性篩選在 U 方向的篩選位移。位移越大，篩選會越遠離 texel 邊界，以避免篩選失真。針對 3D minmip 對應進行篩選時，此值也會套用至 V 方向。

*MinMipSlopeVOrW*\
類型：[D3D12XBOX\_MINMIP\_FILTER\_SLOPE](/zh-TW/reference/graphics/d3d12_xs/enums/d3d12xbox_minmip_filter_slope)

定義 MinMip 雙線性篩選在 V 方向的斜率。斜率越大，篩選外觀越銳利。針對 3D minmip 對應進行篩選時，此值會套用至 W 方向。

*MinMipOffsetVOrW*\
類型：[D3D12XBOX\_MINMIP\_FILTER\_OFFSET](/zh-TW/reference/graphics/d3d12_xs/enums/d3d12xbox_minmip_filter_offset)

定義 MinMip 雙線性篩選在 V 方向的篩選位移。位移越大，篩選會越遠離 texel 邊界，以避免篩選失真。針對 3D minmip 對應進行篩選時，此值會套用至 W 方向。

## 需求

**標頭：** d3d12\_xs.h\
**支援的平台**：XBOX Series 主機

## 另請參閱

[取樣器回饋 Direct3D 12 API 概觀](https://learn.microsoft.com/en-us/gaming/gdk/_content/gc/graphics/newfeatures/sfs/sf-api-design)

[d3d12\_xs](/zh-TW/reference/graphics/d3d12_xs/d3d12_xs_members)


## Related topics

- [NDA 主題目錄 - Microsoft Learn 線上連結](/zh-TW/nda/nda-topic-directory.md)
- [NDA topic directory - live Microsoft Learn links](/nda/nda-topic-directory.md)
- [D3D12_SAMPLER_DESC](/reference/graphics/d3d12/structs/d3d12_sampler_desc_public.md)
- [NDA 主题目录 - Microsoft Learn 在线链接](/zh-CN/nda/nda-topic-directory.md)
- [Répertoire des rubriques NDA : liens actifs vers Microsoft Learn](/fr/nda/nda-topic-directory.md)