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

> 指定纹理采样期间的过滤选项。

指定纹理采样期间的过滤选项。

## 语法

```cpp theme={null}
typedef enum D3D12_FILTER
{
    D3D12_FILTER_MIN_MAG_MIP_POINT = 0,
    D3D12_FILTER_MIN_MAG_POINT_MIP_LINEAR = 1,
    D3D12_FILTER_MIN_POINT_MAG_LINEAR_MIP_POINT = 4,
    D3D12_FILTER_MIN_POINT_MAG_MIP_LINEAR = 5,
    D3D12_FILTER_MIN_LINEAR_MAG_MIP_POINT = 16,
    D3D12_FILTER_MIN_LINEAR_MAG_POINT_MIP_LINEAR = 17,
    D3D12_FILTER_MIN_MAG_LINEAR_MIP_POINT = 20,
    D3D12_FILTER_MIN_MAG_MIP_LINEAR = 21,
    D3D12_FILTER_ANISOTROPIC = 85,
    D3D12_FILTER_COMPARISON_MIN_MAG_MIP_POINT = 128,
    D3D12_FILTER_COMPARISON_MIN_MAG_POINT_MIP_LINEAR = 129,
    D3D12_FILTER_COMPARISON_MIN_POINT_MAG_LINEAR_MIP_POINT = 132,
    D3D12_FILTER_COMPARISON_MIN_POINT_MAG_MIP_LINEAR = 133,
    D3D12_FILTER_COMPARISON_MIN_LINEAR_MAG_MIP_POINT = 144,
    D3D12_FILTER_COMPARISON_MIN_LINEAR_MAG_POINT_MIP_LINEAR = 145,
    D3D12_FILTER_COMPARISON_MIN_MAG_LINEAR_MIP_POINT = 148,
    D3D12_FILTER_COMPARISON_MIN_MAG_MIP_LINEAR = 149,
    D3D12_FILTER_COMPARISON_ANISOTROPIC = 213,
    D3D12_FILTER_MINIMUM_MIN_MAG_MIP_POINT = 256,
    D3D12_FILTER_MINIMUM_MIN_MAG_POINT_MIP_LINEAR = 257,
    D3D12_FILTER_MINIMUM_MIN_POINT_MAG_LINEAR_MIP_POINT = 260,
    D3D12_FILTER_MINIMUM_MIN_POINT_MAG_MIP_LINEAR = 261,
    D3D12_FILTER_MINIMUM_MIN_LINEAR_MAG_MIP_POINT = 272,
    D3D12_FILTER_MINIMUM_MIN_LINEAR_MAG_POINT_MIP_LINEAR = 273,
    D3D12_FILTER_MINIMUM_MIN_MAG_LINEAR_MIP_POINT = 276,
    D3D12_FILTER_MINIMUM_MIN_MAG_MIP_LINEAR = 277,
    D3D12_FILTER_MINIMUM_ANISOTROPIC = 341,
    D3D12_FILTER_MAXIMUM_MIN_MAG_MIP_POINT = 384,
    D3D12_FILTER_MAXIMUM_MIN_MAG_POINT_MIP_LINEAR = 385,
    D3D12_FILTER_MAXIMUM_MIN_POINT_MAG_LINEAR_MIP_POINT = 388,
    D3D12_FILTER_MAXIMUM_MIN_POINT_MAG_MIP_LINEAR = 389,
    D3D12_FILTER_MAXIMUM_MIN_LINEAR_MAG_MIP_POINT = 400,
    D3D12_FILTER_MAXIMUM_MIN_LINEAR_MAG_POINT_MIP_LINEAR = 401,
    D3D12_FILTER_MAXIMUM_MIN_MAG_LINEAR_MIP_POINT = 404,
    D3D12_FILTER_MAXIMUM_MIN_MAG_MIP_LINEAR = 405,
    D3D12_FILTER_MAXIMUM_ANISOTROPIC = 469
} D3D12_FILTER
```

## 常量

| 常量                                                              | 说明                                                                                                                                                                                                                                                                                                                                                              |
| --------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| D3D12\_FILTER\_MIN\_MAG\_MIP\_POINT                             | 对缩小、放大和多级渐远采样使用点采样。                                                                                                                                                                                                                                                                                                                                             |
| D3D12\_FILTER\_MIN\_MAG\_POINT\_MIP\_LINEAR                     | 对缩小和放大使用点采样；对多级渐远采样使用线性插值。                                                                                                                                                                                                                                                                                                                                      |
| D3D12\_FILTER\_MIN\_POINT\_MAG\_LINEAR\_MIP\_POINT              | 对缩小使用点采样；对放大使用线性插值；对多级渐远采样使用点采样。                                                                                                                                                                                                                                                                                                                                |
| D3D12\_FILTER\_MIN\_POINT\_MAG\_MIP\_LINEAR                     | 对缩小使用点采样；对放大和多级渐远采样使用线性插值。                                                                                                                                                                                                                                                                                                                                      |
| D3D12\_FILTER\_MIN\_LINEAR\_MAG\_MIP\_POINT                     | 对缩小使用线性插值；对放大和多级渐远采样使用点采样。                                                                                                                                                                                                                                                                                                                                      |
| D3D12\_FILTER\_MIN\_LINEAR\_MAG\_POINT\_MIP\_LINEAR             | 对缩小使用线性插值；对放大使用点采样；对多级渐远采样使用线性插值。                                                                                                                                                                                                                                                                                                                               |
| D3D12\_FILTER\_MIN\_MAG\_LINEAR\_MIP\_POINT                     | 对缩小和放大使用线性插值；对多级渐远采样使用点采样。                                                                                                                                                                                                                                                                                                                                      |
| D3D12\_FILTER\_MIN\_MAG\_MIP\_LINEAR                            | 对缩小、放大和多级渐远采样使用线性插值。                                                                                                                                                                                                                                                                                                                                            |
| D3D12\_FILTER\_ANISOTROPIC                                      | 对缩小、放大和多级渐远采样使用各向异性插值。                                                                                                                                                                                                                                                                                                                                          |
| D3D12\_FILTER\_COMPARISON\_MIN\_MAG\_MIP\_POINT                 | 对缩小、放大和多级渐远采样使用点采样。将结果与比较值进行比较。                                                                                                                                                                                                                                                                                                                                 |
| D3D12\_FILTER\_COMPARISON\_MIN\_MAG\_POINT\_MIP\_LINEAR         | 对缩小和放大使用点采样；对多级渐远采样使用线性插值。将结果与比较值进行比较。                                                                                                                                                                                                                                                                                                                          |
| D3D12\_FILTER\_COMPARISON\_MIN\_POINT\_MAG\_LINEAR\_MIP\_POINT  | 对缩小使用点采样；对放大使用线性插值；对多级渐远采样使用点采样。将结果与比较值进行比较。                                                                                                                                                                                                                                                                                                                    |
| D3D12\_FILTER\_COMPARISON\_MIN\_POINT\_MAG\_MIP\_LINEAR         | 对缩小使用点采样；对放大和多级渐远采样使用线性插值。将结果与比较值进行比较。                                                                                                                                                                                                                                                                                                                          |
| D3D12\_FILTER\_COMPARISON\_MIN\_LINEAR\_MAG\_MIP\_POINT         | 对缩小使用线性插值；对放大和多级渐远采样使用点采样。将结果与比较值进行比较。                                                                                                                                                                                                                                                                                                                          |
| D3D12\_FILTER\_COMPARISON\_MIN\_LINEAR\_MAG\_POINT\_MIP\_LINEAR | 对缩小使用线性插值；对放大使用点采样；对多级渐远采样使用线性插值。将结果与比较值进行比较。                                                                                                                                                                                                                                                                                                                   |
| D3D12\_FILTER\_COMPARISON\_MIN\_MAG\_LINEAR\_MIP\_POINT         | 对缩小和放大使用线性插值；对多级渐远采样使用点采样。将结果与比较值进行比较。                                                                                                                                                                                                                                                                                                                          |
| D3D12\_FILTER\_COMPARISON\_MIN\_MAG\_MIP\_LINEAR                | 对缩小、放大和多级渐远采样使用线性插值。将结果与比较值进行比较。                                                                                                                                                                                                                                                                                                                                |
| D3D12\_FILTER\_COMPARISON\_ANISOTROPIC                          | 对缩小、放大和多级渐远采样使用各向异性插值。将结果与比较值进行比较。                                                                                                                                                                                                                                                                                                                              |
| D3D12\_FILTER\_MINIMUM\_MIN\_MAG\_MIP\_POINT                    | 提取与 [D3D12\_FILTER\_MIN\_MAG\_MIP\_POINT](/reference/graphics/d3d12/enums/d3d12_filter_public) 相同的一组纹素，但不对其进行过滤，而是返回这些纹素中的最小值。过滤期间权重为 0 的纹素不计入最小值。可以从 [D3D11\_FEATURE\_DATA\_D3D11\_OPTIONS1](https://learn.microsoft.com/en-us/windows/desktop/api/d3d11/ns-d3d11-d3d11_feature_data_d3d11_options1) 结构中的 **MinMaxFiltering** 成员查询此过滤器类型的支持情况。                 |
| D3D12\_FILTER\_MINIMUM\_MIN\_MAG\_POINT\_MIP\_LINEAR            | 提取与 [D3D12\_FILTER\_MIN\_MAG\_POINT\_MIP\_LINEAR](/reference/graphics/d3d12/enums/d3d12_filter_public) 相同的一组纹素，但不对其进行过滤，而是返回这些纹素中的最小值。过滤期间权重为 0 的纹素不计入最小值。可以从 [D3D11\_FEATURE\_DATA\_D3D11\_OPTIONS1](https://learn.microsoft.com/en-us/windows/desktop/api/d3d11/ns-d3d11-d3d11_feature_data_d3d11_options1) 结构中的 **MinMaxFiltering** 成员查询此过滤器类型的支持情况。         |
| D3D12\_FILTER\_MINIMUM\_MIN\_POINT\_MAG\_LINEAR\_MIP\_POINT     | 提取与 [D3D12\_FILTER\_MIN\_POINT\_MAG\_LINEAR\_MIP\_POINT](/reference/graphics/d3d12/enums/d3d12_filter_public) 相同的一组纹素，但不对其进行过滤，而是返回这些纹素中的最小值。过滤期间权重为 0 的纹素不计入最小值。可以从 [D3D11\_FEATURE\_DATA\_D3D11\_OPTIONS1](https://learn.microsoft.com/en-us/windows/desktop/api/d3d11/ns-d3d11-d3d11_feature_data_d3d11_options1) 结构中的 **MinMaxFiltering** 成员查询此过滤器类型的支持情况。  |
| D3D12\_FILTER\_MINIMUM\_MIN\_POINT\_MAG\_MIP\_LINEAR            | 提取与 [D3D12\_FILTER\_MIN\_POINT\_MAG\_MIP\_LINEAR](/reference/graphics/d3d12/enums/d3d12_filter_public) 相同的一组纹素，但不对其进行过滤，而是返回这些纹素中的最小值。过滤期间权重为 0 的纹素不计入最小值。可以从 [D3D11\_FEATURE\_DATA\_D3D11\_OPTIONS1](https://learn.microsoft.com/en-us/windows/desktop/api/d3d11/ns-d3d11-d3d11_feature_data_d3d11_options1) 结构中的 **MinMaxFiltering** 成员查询此过滤器类型的支持情况。         |
| D3D12\_FILTER\_MINIMUM\_MIN\_LINEAR\_MAG\_MIP\_POINT            | 提取与 [D3D12\_FILTER\_MIN\_LINEAR\_MAG\_MIP\_POINT](/reference/graphics/d3d12/enums/d3d12_filter_public) 相同的一组纹素，但不对其进行过滤，而是返回这些纹素中的最小值。过滤期间权重为 0 的纹素不计入最小值。可以从 [D3D11\_FEATURE\_DATA\_D3D11\_OPTIONS1](https://learn.microsoft.com/en-us/windows/desktop/api/d3d11/ns-d3d11-d3d11_feature_data_d3d11_options1) 结构中的 **MinMaxFiltering** 成员查询此过滤器类型的支持情况。         |
| D3D12\_FILTER\_MINIMUM\_MIN\_LINEAR\_MAG\_POINT\_MIP\_LINEAR    | 提取与 [D3D12\_FILTER\_MIN\_LINEAR\_MAG\_POINT\_MIP\_LINEAR](/reference/graphics/d3d12/enums/d3d12_filter_public) 相同的一组纹素，但不对其进行过滤，而是返回这些纹素中的最小值。过滤期间权重为 0 的纹素不计入最小值。可以从 [D3D11\_FEATURE\_DATA\_D3D11\_OPTIONS1](https://learn.microsoft.com/en-us/windows/desktop/api/d3d11/ns-d3d11-d3d11_feature_data_d3d11_options1) 结构中的 **MinMaxFiltering** 成员查询此过滤器类型的支持情况。 |
| D3D12\_FILTER\_MINIMUM\_MIN\_MAG\_LINEAR\_MIP\_POINT            | 提取与 [D3D12\_FILTER\_MIN\_MAG\_LINEAR\_MIP\_POINT](/reference/graphics/d3d12/enums/d3d12_filter_public) 相同的一组纹素，但不对其进行过滤，而是返回这些纹素中的最小值。过滤期间权重为 0 的纹素不计入最小值。可以从 [D3D11\_FEATURE\_DATA\_D3D11\_OPTIONS1](https://learn.microsoft.com/en-us/windows/desktop/api/d3d11/ns-d3d11-d3d11_feature_data_d3d11_options1) 结构中的 **MinMaxFiltering** 成员查询此过滤器类型的支持情况。         |
| D3D12\_FILTER\_MINIMUM\_MIN\_MAG\_MIP\_LINEAR                   | 提取与 [D3D12\_FILTER\_MIN\_MAG\_MIP\_LINEAR](/reference/graphics/d3d12/enums/d3d12_filter_public) 相同的一组纹素，但不对其进行过滤，而是返回这些纹素中的最小值。过滤期间权重为 0 的纹素不计入最小值。可以从 [D3D11\_FEATURE\_DATA\_D3D11\_OPTIONS1](https://learn.microsoft.com/en-us/windows/desktop/api/d3d11/ns-d3d11-d3d11_feature_data_d3d11_options1) 结构中的 **MinMaxFiltering** 成员查询此过滤器类型的支持情况。                |
| D3D12\_FILTER\_MINIMUM\_ANISOTROPIC                             | 提取与 [D3D12\_FILTER\_ANISOTROPIC](/reference/graphics/d3d12/enums/d3d12_filter_public) 相同的一组纹素，但不对其进行过滤，而是返回这些纹素中的最小值。过滤期间权重为 0 的纹素不计入最小值。可以从 [D3D11\_FEATURE\_DATA\_D3D11\_OPTIONS1](https://learn.microsoft.com/en-us/windows/desktop/api/d3d11/ns-d3d11-d3d11_feature_data_d3d11_options1) 结构中的 **MinMaxFiltering** 成员查询此过滤器类型的支持情况。                          |
| D3D12\_FILTER\_MAXIMUM\_MIN\_MAG\_MIP\_POINT                    | 提取与 [D3D12\_FILTER\_MIN\_MAG\_MIP\_POINT](/reference/graphics/d3d12/enums/d3d12_filter_public) 相同的一组纹素，但不对其进行过滤，而是返回这些纹素中的最大值。过滤期间权重为 0 的纹素不计入最大值。可以从 [D3D11\_FEATURE\_DATA\_D3D11\_OPTIONS1](https://learn.microsoft.com/en-us/windows/desktop/api/d3d11/ns-d3d11-d3d11_feature_data_d3d11_options1) 结构中的 **MinMaxFiltering** 成员查询此过滤器类型的支持情况。                 |
| D3D12\_FILTER\_MAXIMUM\_MIN\_MAG\_POINT\_MIP\_LINEAR            | 提取与 [D3D12\_FILTER\_MIN\_MAG\_POINT\_MIP\_LINEAR](/reference/graphics/d3d12/enums/d3d12_filter_public) 相同的一组纹素，但不对其进行过滤，而是返回这些纹素中的最大值。过滤期间权重为 0 的纹素不计入最大值。可以从 [D3D11\_FEATURE\_DATA\_D3D11\_OPTIONS1](https://learn.microsoft.com/en-us/windows/desktop/api/d3d11/ns-d3d11-d3d11_feature_data_d3d11_options1) 结构中的 **MinMaxFiltering** 成员查询此过滤器类型的支持情况。         |
| D3D12\_FILTER\_MAXIMUM\_MIN\_POINT\_MAG\_LINEAR\_MIP\_POINT     | 提取与 [D3D12\_FILTER\_MIN\_POINT\_MAG\_LINEAR\_MIP\_POINT](/reference/graphics/d3d12/enums/d3d12_filter_public) 相同的一组纹素，但不对其进行过滤，而是返回这些纹素中的最大值。过滤期间权重为 0 的纹素不计入最大值。可以从 [D3D11\_FEATURE\_DATA\_D3D11\_OPTIONS1](https://learn.microsoft.com/en-us/windows/desktop/api/d3d11/ns-d3d11-d3d11_feature_data_d3d11_options1) 结构中的 **MinMaxFiltering** 成员查询此过滤器类型的支持情况。  |
| D3D12\_FILTER\_MAXIMUM\_MIN\_POINT\_MAG\_MIP\_LINEAR            | 提取与 [D3D12\_FILTER\_MIN\_POINT\_MAG\_MIP\_LINEAR](/reference/graphics/d3d12/enums/d3d12_filter_public) 相同的一组纹素，但不对其进行过滤，而是返回这些纹素中的最大值。过滤期间权重为 0 的纹素不计入最大值。可以从 [D3D11\_FEATURE\_DATA\_D3D11\_OPTIONS1](https://learn.microsoft.com/en-us/windows/desktop/api/d3d11/ns-d3d11-d3d11_feature_data_d3d11_options1) 结构中的 **MinMaxFiltering** 成员查询此过滤器类型的支持情况。         |
| D3D12\_FILTER\_MAXIMUM\_MIN\_LINEAR\_MAG\_MIP\_POINT            | 提取与 [D3D12\_FILTER\_MIN\_LINEAR\_MAG\_MIP\_POINT](/reference/graphics/d3d12/enums/d3d12_filter_public) 相同的一组纹素，但不对其进行过滤，而是返回这些纹素中的最大值。过滤期间权重为 0 的纹素不计入最大值。可以从 [D3D11\_FEATURE\_DATA\_D3D11\_OPTIONS1](https://learn.microsoft.com/en-us/windows/desktop/api/d3d11/ns-d3d11-d3d11_feature_data_d3d11_options1) 结构中的 **MinMaxFiltering** 成员查询此过滤器类型的支持情况。         |
| D3D12\_FILTER\_MAXIMUM\_MIN\_LINEAR\_MAG\_POINT\_MIP\_LINEAR    | 提取与 [D3D12\_FILTER\_MIN\_LINEAR\_MAG\_POINT\_MIP\_LINEAR](/reference/graphics/d3d12/enums/d3d12_filter_public) 相同的一组纹素，但不对其进行过滤，而是返回这些纹素中的最大值。过滤期间权重为 0 的纹素不计入最大值。可以从 [D3D11\_FEATURE\_DATA\_D3D11\_OPTIONS1](https://learn.microsoft.com/en-us/windows/desktop/api/d3d11/ns-d3d11-d3d11_feature_data_d3d11_options1) 结构中的 **MinMaxFiltering** 成员查询此过滤器类型的支持情况。 |
| D3D12\_FILTER\_MAXIMUM\_MIN\_MAG\_LINEAR\_MIP\_POINT            | 提取与 [D3D12\_FILTER\_MIN\_MAG\_LINEAR\_MIP\_POINT](/reference/graphics/d3d12/enums/d3d12_filter_public) 相同的一组纹素，但不对其进行过滤，而是返回这些纹素中的最大值。过滤期间权重为 0 的纹素不计入最大值。可以从 [D3D11\_FEATURE\_DATA\_D3D11\_OPTIONS1](https://learn.microsoft.com/en-us/windows/desktop/api/d3d11/ns-d3d11-d3d11_feature_data_d3d11_options1) 结构中的 **MinMaxFiltering** 成员查询此过滤器类型的支持情况。         |
| D3D12\_FILTER\_MAXIMUM\_MIN\_MAG\_MIP\_LINEAR                   | 提取与 [D3D12\_FILTER\_MIN\_MAG\_MIP\_LINEAR](/reference/graphics/d3d12/enums/d3d12_filter_public) 相同的一组纹素，但不对其进行过滤，而是返回这些纹素中的最大值。过滤期间权重为 0 的纹素不计入最大值。可以从 [D3D11\_FEATURE\_DATA\_D3D11\_OPTIONS1](https://learn.microsoft.com/en-us/windows/desktop/api/d3d11/ns-d3d11-d3d11_feature_data_d3d11_options1) 结构中的 **MinMaxFiltering** 成员查询此过滤器类型的支持情况。                |
| D3D12\_FILTER\_MAXIMUM\_ANISOTROPIC                             | 提取与 [D3D12\_FILTER\_ANISOTROPIC](/reference/graphics/d3d12/enums/d3d12_filter_public) 相同的一组纹素，但不对其进行过滤，而是返回这些纹素中的最大值。过滤期间权重为 0 的纹素不计入最大值。可以从 [D3D11\_FEATURE\_DATA\_D3D11\_OPTIONS1](https://learn.microsoft.com/en-us/windows/desktop/api/d3d11/ns-d3d11-d3d11_feature_data_d3d11_options1) 结构中的 **MinMaxFiltering** 成员查询此过滤器类型的支持情况。                          |

## 注解

此枚举由 [D3D12\_SAMPLER\_DESC](/reference/graphics/d3d12/structs/d3d12_sampler_desc_public) 结构使用。

<div class="alert">**注意**  如果对最小过滤器和放大过滤器使用不同的过滤器类型，在某些情况下（是发生放大还是缩小的选择不明确时）会出现未定义行为。为防止这种未定义行为，请使用对最小和放大都采用相似过滤器操作的过滤模式（或使用各向异性过滤，它也可以避免此问题）。</div>

<div />

在纹理采样期间，会读取一个或多个纹素并将其组合（即过滤）以生成单个值。点采样读取单个纹素，而线性采样读取两个纹素（端点）并在这两个端点之间线性插值第三个值。

Microsoft 高级着色语言 (HLSL) 纹理采样函数也在纹理采样期间支持比较过滤。比较过滤将每个采样的纹素与比较值进行比较。布尔结果的混合方式与普通纹理过滤的混合方式相同。

可以使用仅实现纹理过滤的 HLSL 内置纹理采样函数，或将纹理过滤与比较过滤结合使用的伴随函数。

另请注意以下定义：

```syntax theme={null}
#define D3D12_FILTER_REDUCTION_TYPE_MASK ( 0x3 )

#define D3D12_FILTER_REDUCTION_TYPE_SHIFT ( 7 )

#define D3D12_FILTER_TYPE_MASK ( 0x3 )

#define D3D12_MIN_FILTER_SHIFT ( 4 )

#define D3D12_MAG_FILTER_SHIFT ( 2 )

#define D3D12_MIP_FILTER_SHIFT ( 0 )

#define D3D12_ANISOTROPIC_FILTERING_BIT ( 0x40 )

#define D3D12_ENCODE_BASIC_FILTER( min, mag, mip, reduction )                                                     \
( ( D3D12_FILTER ) (                                                           \
( ( ( min ) &amp; D3D12_FILTER_TYPE_MASK ) &lt;&lt; D3D12_MIN_FILTER_SHIFT ) |           \
( ( ( mag ) &amp; D3D12_FILTER_TYPE_MASK ) &lt;&lt; D3D12_MAG_FILTER_SHIFT ) |           \
( ( ( mip ) &amp; D3D12_FILTER_TYPE_MASK ) &lt;&lt; D3D12_MIP_FILTER_SHIFT ) |           \
( ( ( reduction ) &amp; D3D12_FILTER_REDUCTION_TYPE_MASK ) &lt;&lt; D3D12_FILTER_REDUCTION_TYPE_SHIFT ) ) )
#define D3D12_ENCODE_ANISOTROPIC_FILTER( reduction )                                                  \
( ( D3D12_FILTER ) (                                         \
D3D12_ANISOTROPIC_FILTERING_BIT |                            \
D3D12_ENCODE_BASIC_FILTER( D3D12_FILTER_TYPE_LINEAR,         \
D3D12_FILTER_TYPE_LINEAR,         \
D3D12_FILTER_TYPE_LINEAR,         \
reduction ) ) )
#define D3D12_DECODE_MIN_FILTER( D3D12Filter )                                                              \
( ( D3D12_FILTER_TYPE )                                                    \
( ( ( D3D12Filter ) &gt;&gt; D3D12_MIN_FILTER_SHIFT ) &amp; D3D12_FILTER_TYPE_MASK ) )
#define D3D12_DECODE_MAG_FILTER( D3D12Filter )                                                              \
( ( D3D12_FILTER_TYPE )                                                    \
( ( ( D3D12Filter ) &gt;&gt; D3D12_MAG_FILTER_SHIFT ) &amp; D3D12_FILTER_TYPE_MASK ) )
#define D3D12_DECODE_MIP_FILTER( D3D12Filter )                                                              \
( ( D3D12_FILTER_TYPE )                                                    \
( ( ( D3D12Filter ) &gt;&gt; D3D12_MIP_FILTER_SHIFT ) &amp; D3D12_FILTER_TYPE_MASK ) )
#define D3D12_DECODE_FILTER_REDUCTION( D3D12Filter )                                                        \
( ( D3D12_FILTER_REDUCTION_TYPE )                                                      \
( ( ( D3D12Filter ) &gt;&gt; D3D12_FILTER_REDUCTION_TYPE_SHIFT ) &amp; D3D12_FILTER_REDUCTION_TYPE_MASK ) )
#define D3D12_DECODE_IS_COMPARISON_FILTER( D3D12Filter )                                                    \
( D3D12_DECODE_FILTER_REDUCTION( D3D12Filter ) == D3D12_FILTER_REDUCTION_TYPE_COMPARISON )
#define D3D12_DECODE_IS_ANISOTROPIC_FILTER( D3D12Filter )                                               \
( ( ( D3D12Filter ) &amp; D3D12_ANISOTROPIC_FILTERING_BIT ) &amp;&amp;                  \
( D3D12_FILTER_TYPE_LINEAR == D3D12_DECODE_MIN_FILTER( D3D12Filter ) ) &amp;&amp;   \
( D3D12_FILTER_TYPE_LINEAR == D3D12_DECODE_MAG_FILTER( D3D12Filter ) ) &amp;&amp;   \
( D3D12_FILTER_TYPE_LINEAR == D3D12_DECODE_MIP_FILTER( D3D12Filter ) ) )


```

| 纹理采样函数                                                                                              | 带比较过滤的纹理采样函数                                                                                                                                                                                                                            |
| --------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| [Sample](https://learn.microsoft.com/en-us/windows/desktop/direct3dhlsl/dx-graphics-hlsl-to-sample) | [SampleCmp](https://learn.microsoft.com/en-us/windows/desktop/direct3dhlsl/dx-graphics-hlsl-to-samplecmp) 或 [SampleCmpLevelZero](https://learn.microsoft.com/en-us/windows/desktop/direct3dhlsl/dx-graphics-hlsl-to-samplecmplevelzero) |

比较过滤器仅适用于具有以下格式的纹理：[DXGI\_FORMAT\_R32\_FLOAT\_X8X24\_TYPELESS](https://learn.microsoft.com/en-us/windows/desktop/api/dxgiformat/ne-dxgiformat-dxgi_format)、[DXGI\_FORMAT\_R32\_FLOAT](https://learn.microsoft.com/en-us/windows/desktop/api/dxgiformat/ne-dxgiformat-dxgi_format)、[DXGI\_FORMAT\_R24\_UNORM\_X8\_TYPELESS](https://learn.microsoft.com/en-us/windows/desktop/api/dxgiformat/ne-dxgiformat-dxgi_format)、[DXGI\_FORMAT\_R16\_UNORM](https://learn.microsoft.com/en-us/windows/desktop/api/dxgiformat/ne-dxgiformat-dxgi_format)。

## 要求

**头文件：** 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-enumerations)

[描述符](https://learn.microsoft.com/en-us/windows/desktop/direct3d12/descriptors)


## Related topics

- [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_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)
- [D3D12_FEATURE](/zh-CN/reference/graphics/d3d12/enums/d3d12_feature_public.md)
