> ## 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 (família XBOX One)

> D3D12XBOX_SAMPLER_DESC (consoles da família XBOX One) — Descreve um estado de amostrador. Referência da API de gráficos Direct3D 12 para desenvolvimento de jogos XBOX.

Descreve um estado de amostrador.

## Sintaxe

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

### Membros

*Flags*\
Tipo: [D3D12XBOX\_SAMPLER\_FLAGS](/pt-BR/reference/graphics/d3d12_x/enums/d3d12xbox_sampler_flags)

Um sinalizador da enumeração **D3D12XBOX\_SAMPLER\_FLAGS**.

*FilterMag*\
Tipo: [D3D12XBOX\_TEXTURE\_XY\_FILTER](/pt-BR/reference/graphics/d3d12_x/enums/d3d12xbox_texture_xy_filter)

Este valor da enumeração **D3D12XBOX\_TEXTURE\_XY\_FILTER** especifica o filtro XY a ser usado.

*FilterMin*\
Tipo: [D3D12XBOX\_TEXTURE\_XY\_FILTER](/pt-BR/reference/graphics/d3d12_x/enums/d3d12xbox_texture_xy_filter)

Este valor da enumeração **D3D12XBOX\_TEXTURE\_XY\_FILTER** especifica o filtro XY a ser usado.

*FilterMip*\
Tipo: [D3D12XBOX\_TEXTURE\_MIP\_FILTER](/pt-BR/reference/graphics/d3d12_x/enums/d3d12xbox_texture_mip_filter)

Este valor da enumeração **D3D12XBOX\_TEXTURE\_MIP\_FILTER** especifica o filtro MIP a ser usado.

*FilterZ*\
Tipo: [D3D12XBOX\_TEXTURE\_Z\_FILTER](/pt-BR/reference/graphics/d3d12_x/enums/d3d12xbox_texture_z_filter)

Este valor da enumeração **D3D12XBOX\_TEXTURE\_Z\_FILTER** especifica o filtro Z a ser usado.

*FilterMode*\
Tipo: [D3D12XBOX\_TEXTURE\_FILTER\_MODE](/pt-BR/reference/graphics/d3d12_x/enums/d3d12xbox_texture_filter_mode)

Este valor da enumeração **D3D12XBOX\_TEXTURE\_FILTER\_MODE** especifica o método de filtragem a ser usado para amostrar uma textura.

*AddressU*\
Tipo: [D3D12\_TEXTURE\_ADDRESS\_MODE](/pt-BR/reference/graphics/d3d12_x/enums/d3d12_texture_address_mode)

Este valor da enumeração **D3D12\_TEXTURE\_ADDRESS\_MODE** especifica o método a ser usado para resolver uma coordenada de textura u que esteja fora do intervalo de 0 a 1.

*AddressV*\
Tipo: [D3D12\_TEXTURE\_ADDRESS\_MODE](/pt-BR/reference/graphics/d3d12_x/enums/d3d12_texture_address_mode)

Este valor da enumeração **D3D12\_TEXTURE\_ADDRESS\_MODE** especifica o método a ser usado para resolver uma coordenada de textura v que esteja fora do intervalo de 0 a 1.

*AddressW*\
Tipo: [D3D12\_TEXTURE\_ADDRESS\_MODE](/pt-BR/reference/graphics/d3d12_x/enums/d3d12_texture_address_mode)

Este valor da enumeração **D3D12\_TEXTURE\_ADDRESS\_MODE** especifica o método a ser usado para resolver uma coordenada de textura w que esteja fora do intervalo de 0 a 1.

*MinLOD*\
Tipo: FLOAT

Extremidade inferior do intervalo de mipmaps ao qual o acesso será limitado. 0 é o nível de mipmap maior e mais detalhado, e qualquer nível acima dele é menos detalhado.

*MaxLOD*\
Tipo: FLOAT

Extremidade superior do intervalo de mipmaps ao qual o acesso será limitado. 0 é o nível de mipmap maior e mais detalhado, e qualquer nível acima dele é menos detalhado. Esse valor deve ser maior ou igual a MinLOD. Para não ter limite superior de LOD, defina esse membro como um valor grande.

*MipLODBias*\
Tipo: FLOAT

Deslocamento em relação ao nível de mipmap calculado. Por exemplo, se o cálculo do runtime indicar que uma textura deve ser amostrada no nível de mipmap 3 e MipLODBias for 2, a textura será amostrada no nível de mipmap 5.

*MipLODBiasSecondary*\
Tipo: FLOAT

O deslocamento secundário em relação ao nível de mipmap calculado.

*MaxAnisotropy*\
Tipo: UINT

Valor de limitação usado se **D3D12\_FILTER\_ANISOTROPIC** ou **D3D12\_FILTER\_COMPARISON\_ANISOTROPIC** for especificado em Filter. Os valores válidos estão entre 1 e 16.

*AnisotropyBias*\
Tipo: FLOAT

Para reduzir a anisotropia calculada, este campo u1.5 é subtraído da proporção anisotrópica calculada. A subtração ocorre no espaço logarítmico, portanto 1.0 reduziria pela metade a proporção anisotrópica e o número de amostras coletadas. Quanto maior o valor, mais qualidade é sacrificada em favor do desempenho. O Anisobias pode ser reduzido pelo campo PERF\_MOD do recurso, por recurso. O final\_aniso\_degree é 2^(aniso\_degree\_exp - AnisotropicBias). A redução máxima com esse viés é de quase 4.

*AnisotropyThreshold*\
Tipo: UINT

Ajusta as compensações entre desempenho e qualidade relacionadas à filtragem anisotrópica no hardware de amostragem de textura. Valores maiores levam a um desempenho maior e a uma qualidade de amostragem menor.

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

Um valor do tipo D3D12\_COMPARISON\_FUNC que especifica uma função que compara os dados amostrados com dados amostrados existentes.

*BorderColor*\
Tipo: FLOAT\[4]

Cor da borda a ser usada se **D3D12\_TEXTURE\_ADDRESS\_MODE\_BORDER** for especificado para **AddressU**, **AddressV** ou **AddressW**. O intervalo deve ser de 0.0 a 1.0, inclusive.

*PerformanceMip*\
Tipo: UINT

Ajusta as compensações entre desempenho e qualidade relacionadas à filtragem de mip no hardware de amostragem de textura. Valores maiores levam a um desempenho maior e a uma qualidade de amostragem menor.

*PerformanceZ*\
Tipo: UINT

Ajusta as compensações entre desempenho e qualidade relacionadas à filtragem de profundidade no hardware de amostragem de textura. Valores maiores levam a um desempenho maior e a uma qualidade de amostragem menor.

## Requisitos

**Cabeçalho:** d3d12\_x.h

**Plataformas com suporte:** família XBOX One

## Confira também

[d3d12\_x](/pt-BR/reference/graphics/d3d12_x/d3d12_x_members)


## Related topics

- [Diretório de tópicos NDA: links ativos do Microsoft Learn](/pt-BR/nda/nda-topic-directory.md)
- [D3D12_SAMPLER_DESC](/es/reference/graphics/d3d12/structs/d3d12_sampler_desc_public.md)
- [D3D12_STATIC_SAMPLER_DESC](/es/reference/graphics/d3d12/structs/d3d12_static_sampler_desc_public.md)
- [Directorio de temas NDA: enlaces activos a Microsoft Learn](/es/nda/nda-topic-directory.md)
- [NDA topic directory - live Microsoft Learn links](/nda/nda-topic-directory.md)