> ## 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 (consoles XBOX Series)

> D3D12XBOX_SAMPLER_DESC (consoles XBOX Series) — Décrit un état d'échantillonneur. Référence de l'API graphique Direct3D 12 pour le développement de jeux XBOX.

Décrit un état d'échantillonneur.

## Syntaxe

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

### Membres

*Flags*\
Type : [D3D12XBOX\_SAMPLER\_FLAGS](/fr-CA/reference/graphics/d3d12_xs/enums/d3d12xbox_sampler_flags_xs)

Indicateur de l'énumération **D3D12XBOX\_SAMPLER\_FLAGS**.

*FilterMag*\
Type : [D3D12XBOX\_TEXTURE\_XY\_FILTER](/fr-CA/reference/graphics/d3d12_x/enums/d3d12xbox_texture_xy_filter)

Cette valeur de l'énumération **D3D12XBOX\_TEXTURE\_XY\_FILTER** spécifie le filtre XY à utiliser.

*FilterMin*\
Type : [D3D12XBOX\_TEXTURE\_XY\_FILTER](/fr-CA/reference/graphics/d3d12_x/enums/d3d12xbox_texture_xy_filter)

Cette valeur de l'énumération **D3D12XBOX\_TEXTURE\_XY\_FILTER** spécifie le filtre XY à utiliser.

*FilterMip*\
Type : [D3D12XBOX\_TEXTURE\_MIP\_FILTER](/fr-CA/reference/graphics/d3d12_x/enums/d3d12xbox_texture_mip_filter)

Cette valeur de l'énumération **D3D12XBOX\_TEXTURE\_MIP\_FILTER** spécifie le filtre MIP à utiliser.

*FilterZ*\
Type : [D3D12XBOX\_TEXTURE\_Z\_FILTER](/fr-CA/reference/graphics/d3d12_x/enums/d3d12xbox_texture_z_filter)

Cette valeur de l'énumération **D3D12XBOX\_TEXTURE\_Z\_FILTER** spécifie le filtre Z à utiliser.

*FilterMode*\
Type : [D3D12XBOX\_TEXTURE\_FILTER\_MODE](/fr-CA/reference/graphics/d3d12_x/enums/d3d12xbox_texture_filter_mode)

Cette valeur de l'énumération **D3D12XBOX\_TEXTURE\_FILTER\_MODE** spécifie la méthode de filtrage à utiliser pour l'échantillonnage d'une texture.

*AddressU*\
Type : [D3D12\_TEXTURE\_ADDRESS\_MODE](/fr-CA/reference/graphics/d3d12_x/enums/d3d12_texture_address_mode)

Cette valeur de l'énumération **D3D12\_TEXTURE\_ADDRESS\_MODE** spécifie la méthode à utiliser pour résoudre une coordonnée de texture u située en dehors de la plage 0-1.

*AddressV*\
Type : [D3D12\_TEXTURE\_ADDRESS\_MODE](/fr-CA/reference/graphics/d3d12_x/enums/d3d12_texture_address_mode)

Cette valeur de l'énumération **D3D12\_TEXTURE\_ADDRESS\_MODE** spécifie la méthode à utiliser pour résoudre une coordonnée de texture v située en dehors de la plage 0-1.

*AddressW*\
Type : [D3D12\_TEXTURE\_ADDRESS\_MODE](/fr-CA/reference/graphics/d3d12_x/enums/d3d12_texture_address_mode)

Cette valeur de l'énumération **D3D12\_TEXTURE\_ADDRESS\_MODE** spécifie la méthode à utiliser pour résoudre une coordonnée de texture w située en dehors de la plage 0-1.

*MinLOD*\
Type : FLOAT

Extrémité inférieure de la plage de mipmaps à laquelle l'accès est limité. 0 correspond au niveau de mipmap le plus grand et le plus détaillé; tout niveau supérieur est moins détaillé.

*MaxLOD*\
Type : FLOAT

Extrémité supérieure de la plage de mipmaps à laquelle l'accès est limité. 0 correspond au niveau de mipmap le plus grand et le plus détaillé; tout niveau supérieur est moins détaillé. Cette valeur doit être supérieure ou égale à MinLOD. Pour n'avoir aucune limite supérieure de LOD, définissez ce membre sur une valeur élevée.

*MipLODBias*\
Type : FLOAT

Décalage par rapport au niveau de mipmap calculé. Par exemple, si le calcul du runtime indique qu'une texture doit être échantillonnée au niveau de mipmap 3 et que MipLODBias vaut 2, la texture sera échantillonnée au niveau de mipmap 5.

*MipLODBiasSecondary*\
Type : FLOAT

Décalage secondaire par rapport au niveau de mipmap calculé.

*MaxAnisotropy*\
Type : UINT

Valeur de limitation utilisée si **D3D12\_FILTER\_ANISOTROPIC** ou **D3D12\_FILTER\_COMPARISON\_ANISOTROPIC** est spécifié dans Filter. Les valeurs valides sont comprises entre 1 et 16.

*AnisotropyBias*\
Type : FLOAT

Pour réduire l'anisotropie calculée, ce champ u1.5 est soustrait du rapport anisotrope calculé. La soustraction s'effectue dans l'espace logarithmique; ainsi, 1.0 diviserait par deux le rapport anisotrope et le nombre d'échantillons prélevés. Plus la valeur est élevée, plus la qualité est sacrifiée au profit des performances. Anisobias peut être réduit par le champ PERF\_MOD de la ressource, ressource par ressource. Le final\_aniso\_degree est 2^(aniso\_degree\_exp - AnisotropicBias). La réduction maximale avec ce biais est de près de 4.

*AnisotropyThreshold*\
Type : UINT

Ajuste les compromis performances-qualité liés au filtrage anisotrope dans le matériel d'échantillonnage de textures. Des valeurs plus élevées entraînent de meilleures performances et une qualité d'échantillonnage moindre.

*ComparisonFunc*\
Type : D3D12\_COMPARISON\_FUNC

Valeur de type D3D12\_COMPARISON\_FUNC qui spécifie une fonction comparant les données échantillonnées aux données échantillonnées existantes.

*BorderColor*\
Type : FLOAT\[4]

Couleur de bordure à utiliser si **D3D12\_TEXTURE\_ADDRESS\_MODE\_BORDER** est spécifié pour **AddressU**, **AddressV** ou **AddressW**. La plage doit être comprise entre 0.0 et 1.0 inclusivement.

*PerformanceMip*\
Type : UINT

Ajuste les compromis performances-qualité liés au filtrage des mips dans le matériel d'échantillonnage de textures. Des valeurs plus élevées entraînent de meilleures performances et une qualité d'échantillonnage moindre.

*PerformanceZ*\
Type : UINT

Ajuste les compromis performances-qualité liés au filtrage de profondeur dans le matériel d'échantillonnage de textures. Des valeurs plus élevées entraînent de meilleures performances et une qualité d'échantillonnage moindre.

*MinMipSlopeU*\
Type : [D3D12XBOX\_MINMIP\_FILTER\_SLOPE](/fr-CA/reference/graphics/d3d12_xs/enums/d3d12xbox_minmip_filter_slope)

Définit la pente dans la direction U pour le filtre bilinéaire MinMip. Des pentes plus fortes donnent un filtre d'apparence plus nette. Pour le filtrage sur une carte minmip 3D, cette valeur s'applique également à la direction V.

*MinMipOffsetU*\
Type : [D3D12XBOX\_MINMIP\_FILTER\_OFFSET](/fr-CA/reference/graphics/d3d12_xs/enums/d3d12xbox_minmip_filter_offset)

Définit le décalage du filtre dans la direction U pour le filtre bilinéaire MinMip. Des décalages plus grands éloignent le filtre de la limite des texels afin d'éviter les artefacts de filtrage. Pour le filtrage sur une carte minmip 3D, cette valeur s'applique également à la direction V.

*MinMipSlopeVOrW*\
Type : [D3D12XBOX\_MINMIP\_FILTER\_SLOPE](/fr-CA/reference/graphics/d3d12_xs/enums/d3d12xbox_minmip_filter_slope)

Définit la pente dans la direction V pour le filtre bilinéaire MinMip. Des pentes plus fortes donnent un filtre d'apparence plus nette. Pour le filtrage sur une carte minmip 3D, cette valeur s'applique à la direction W.

*MinMipOffsetVOrW*\
Type : [D3D12XBOX\_MINMIP\_FILTER\_OFFSET](/fr-CA/reference/graphics/d3d12_xs/enums/d3d12xbox_minmip_filter_offset)

Définit le décalage du filtre dans la direction V pour le filtre bilinéaire MinMip. Des décalages plus grands éloignent le filtre de la limite des texels afin d'éviter les artefacts de filtrage. Pour le filtrage sur une carte minmip 3D, cette valeur s'applique à la direction W.

## Configuration requise

**En-tête :** d3d12\_xs.h\
**Plateformes prises en charge** : consoles XBOX Series

## Voir aussi

[Vue d'ensemble de l'API Direct3D 12 de retour d'échantillonneur](https://learn.microsoft.com/en-us/gaming/gdk/_content/gc/graphics/newfeatures/sfs/sf-api-design)

[d3d12\_xs](/fr-CA/reference/graphics/d3d12_xs/d3d12_xs_members)


## Related topics

- [Répertoire des rubriques NDA : liens actifs vers Microsoft Learn](/fr/nda/nda-topic-directory.md)
- [Diretório de tópicos NDA: links ativos do Microsoft Learn](/pt-BR/nda/nda-topic-directory.md)
- [D3D12_EXPORT_DESC (XBOX Series consoles)](/reference/graphics/d3d12/structs/d3d12_export_desc_public.md)
- [D3D12_DISPATCH_RAYS_DESC (XBOX Series consoles)](/reference/graphics/d3d12/structs/d3d12_dispatch_rays_desc_public.md)
- [D3D12_RAYTRACING_GEOMETRY_DESC (XBOX Series consoles)](/reference/graphics/d3d12/structs/d3d12_raytracing_geometry_desc_public.md)
