> ## 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) — 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_MINMIP_FILTER_SLOPE MinMipSlopeU; D3D12XBOX_MINMIP_FILTER_OFFSET MinMipOffsetU; D3D12XBOX_MINMIP_FILTER_SLOPE MinMipSlopeVOrW; D3D12XBOX_MINMIP_FILTER_OFFSET MinMipOffsetVOrW; } D3D12XBOX_SAMPLER_DESC ``` ### Membros *Flags*\ Tipo: [D3D12XBOX\_SAMPLER\_FLAGS](/pt-BR/reference/graphics/d3d12_xs/enums/d3d12xbox_sampler_flags_xs) Um sinalizador na enumeração **D3D12XBOX\_SAMPLER\_FLAGS**. *FilterMag*\ Tipo: [D3D12XBOX\_TEXTURE\_XY\_FILTER](/pt-BR/reference/graphics/d3d12_x/enums/d3d12xbox_texture_xy_filter) Este valor na 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 na 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 na 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 na 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 na 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 na enumeração **D3D12\_TEXTURE\_ADDRESS\_MODE** especifica o método a ser usado para resolver uma coordenada de textura u que está fora do intervalo 0-1. *AddressV*\ Tipo: [D3D12\_TEXTURE\_ADDRESS\_MODE](/pt-BR/reference/graphics/d3d12_x/enums/d3d12_texture_address_mode) Este valor na enumeração **D3D12\_TEXTURE\_ADDRESS\_MODE** especifica o método a ser usado para resolver uma coordenada de textura v que está fora do intervalo 0-1. *AddressW*\ Tipo: [D3D12\_TEXTURE\_ADDRESS\_MODE](/pt-BR/reference/graphics/d3d12_x/enums/d3d12_texture_address_mode) Este valor na enumeração **D3D12\_TEXTURE\_ADDRESS\_MODE** especifica o método a ser usado para resolver uma coordenada de textura w que está fora do intervalo 0-1. *MinLOD*\ Tipo: FLOAT Extremidade inferior do intervalo de mipmap 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 mipmap 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 este membro com 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 texturas. Valores maiores resultam em desempenho mais alto e menor qualidade de amostragem. *ComparisonFunc*\ Tipo: D3D12\_COMPARISON\_FUNC 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 texturas. Valores maiores resultam em desempenho mais alto e menor qualidade de amostragem. *PerformanceZ*\ Tipo: UINT Ajusta as compensações entre desempenho e qualidade relacionadas à filtragem de profundidade no hardware de amostragem de texturas. Valores maiores resultam em desempenho mais alto e menor qualidade de amostragem. *MinMipSlopeU*\ Tipo: [D3D12XBOX\_MINMIP\_FILTER\_SLOPE](/pt-BR/reference/graphics/d3d12_xs/enums/d3d12xbox_minmip_filter_slope) Define a inclinação na direção U para o filtro bilinear MinMip. Inclinações maiores resultam em uma aparência de filtro mais nítida. Para filtragem em um mapa minmip 3D, esse valor também se aplica à direção V. *MinMipOffsetU*\ Tipo: [D3D12XBOX\_MINMIP\_FILTER\_OFFSET](/pt-BR/reference/graphics/d3d12_xs/enums/d3d12xbox_minmip_filter_offset) Define o deslocamento do filtro na direção U para o filtro bilinear MinMip. Deslocamentos maiores afastam o filtro do limite do texel para evitar artefatos de filtragem. Para filtragem em um mapa minmip 3D, esse valor também se aplica à direção V. *MinMipSlopeVOrW*\ Tipo: [D3D12XBOX\_MINMIP\_FILTER\_SLOPE](/pt-BR/reference/graphics/d3d12_xs/enums/d3d12xbox_minmip_filter_slope) Define a inclinação na direção V para o filtro bilinear MinMip. Inclinações maiores resultam em uma aparência de filtro mais nítida. Para filtragem em um mapa minmip 3D, esse valor se aplica à direção W. *MinMipOffsetVOrW*\ Tipo: [D3D12XBOX\_MINMIP\_FILTER\_OFFSET](/pt-BR/reference/graphics/d3d12_xs/enums/d3d12xbox_minmip_filter_offset) Define o deslocamento do filtro na direção V para o filtro bilinear MinMip. Deslocamentos maiores afastam o filtro do limite do texel para evitar artefatos de filtragem. Para filtragem em um mapa minmip 3D, esse valor se aplica à direção W. ## Requisitos **Cabeçalho:** d3d12\_xs.h\ **Plataformas compatíveis**: consoles XBOX Series ## Confira também [Visão geral da API Direct3D 12 de Sampler Feedback](https://learn.microsoft.com/en-us/gaming/gdk/_content/gc/graphics/newfeatures/sfs/sf-api-design) [d3d12\_xs](/pt-BR/reference/graphics/d3d12_xs/d3d12_xs_members) ## Related topics - [Diretório de tópicos NDA: links ativos do Microsoft Learn](/pt-BR/nda/nda-topic-directory.md) - [D3D12_EXPORT_DESC (consoles XBOX Series)](/pt-BR/reference/graphics/d3d12/structs/d3d12_export_desc_public.md) - [D3D12_DISPATCH_RAYS_DESC (consoles XBOX Series)](/pt-BR/reference/graphics/d3d12/structs/d3d12_dispatch_rays_desc_public.md) - [D3D12_RAYTRACING_GEOMETRY_DESC (consoles XBOX Series)](/pt-BR/reference/graphics/d3d12/structs/d3d12_raytracing_geometry_desc_public.md) - [D3D12_DXIL_LIBRARY_DESC (consoles XBOX Series)](/pt-BR/reference/graphics/d3d12/structs/d3d12_dxil_library_desc_public.md)