> ## 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](/reference/graphics/d3d12/enums/d3d12_filter_public) 类型的值，用于指定采样纹理时使用的筛选方法。

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

一个 [D3D12\_TEXTURE\_ADDRESS\_MODE](/reference/graphics/d3d12_x/enums/d3d12_texture_address_mode) 类型的值，用于指定解析超出 0 到 1 范围的 u 纹理坐标所使用的方法。

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

一个 [D3D12\_TEXTURE\_ADDRESS\_MODE](/reference/graphics/d3d12_x/enums/d3d12_texture_address_mode) 类型的值，用于指定解析超出 0 到 1 范围的 v 纹理坐标所使用的方法。

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

一个 [D3D12\_TEXTURE\_ADDRESS\_MODE](/reference/graphics/d3d12_x/enums/d3d12_texture_address_mode) 类型的值，用于指定解析超出 0 到 1 范围的 w 纹理坐标所使用的方法。

*MipLODBias*\
类型：FLOAT

与计算出的 mipmap 级别的偏移量。例如，如果运行时计算得出纹理应在 mipmap 级别 3 处采样，且 **MipLODBias** 为 2，则纹理将在 mipmap 级别 5 处采样。

*MaxAnisotropy*\
类型：UINT

当在 **Filter** 中指定了 **D3D12\_FILTER\_ANISOTROPIC** 或 **D3D12\_FILTER\_COMPARISON\_ANISOTROPIC** 时使用的钳制值。有效值介于 1 和 16 之间。

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

一个 [D3D12\_COMPARISON\_FUNC](/reference/graphics/d3d12/enums/d3d12_comparison_func_public) 类型的值，用于指定将采样数据与现有采样数据进行比较的函数。

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

当为 **AddressU**、**AddressV** 或 **AddressW** 指定 [D3D12\_TEXTURE\_ADDRESS\_MODE\_BORDER](/reference/graphics/d3d12_x/enums/d3d12_texture_address_mode) 时使用的 RGBA 边框颜色。范围必须介于 0.0 到 1.0 之间（包含两端）。

*MinLOD*\
类型：FLOAT

用于钳制访问的 mipmap 范围的下限，其中 0 是最大且最详细的 mipmap 级别，任何高于该级别的级别的详细程度都较低。

*MaxLOD*\
类型：FLOAT

用于钳制访问的 mipmap 范围的上限，其中 0 是最大且最详细的 mipmap 级别，任何高于该级别的级别的详细程度都较低。此值必须大于或等于 **MinLOD**。若要 LOD 无上限，请将此成员设置为较大的值。

## 备注

此结构由 [CreateSampler](/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 系列

## 另请参阅

[Core Structures](https://learn.microsoft.com/en-us/windows/desktop/direct3d12/direct3d-12-structures)


## Related topics

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