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

> Define constantes que especificam um recurso ou conjunto de recursos do Direct3D 12 a ser consultado.

Define constantes que especificam um recurso ou conjunto de recursos do Direct3D 12 a ser consultado. Quando quiser consultar o nível de suporte de um adaptador a um recurso, passe um destes valores para [ID3D12Device::CheckFeatureSupport](/pt-BR/reference/graphics/d3d12/interfaces/id3d12device/methods/id3d12device_checkfeaturesupport_public).

## Sintaxe

```cpp theme={null}
typedef enum D3D12_FEATURE
{
    D3D12_FEATURE_D3D12_OPTIONS = 0,
    D3D12_FEATURE_ARCHITECTURE = 1,
    D3D12_FEATURE_FEATURE_LEVELS = 2,
    D3D12_FEATURE_FORMAT_SUPPORT = 3,
    D3D12_FEATURE_MULTISAMPLE_QUALITY_LEVELS = 4,
    D3D12_FEATURE_FORMAT_INFO = 5,
    D3D12_FEATURE_GPU_VIRTUAL_ADDRESS_SUPPORT = 6,
    D3D12_FEATURE_SHADER_MODEL = 7,
    D3D12_FEATURE_D3D12_OPTIONS1 = 8,
    D3D12_FEATURE_PROTECTED_RESOURCE_SESSION_SUPPORT = 10,
    D3D12_FEATURE_ROOT_SIGNATURE = 12,
    D3D12_FEATURE_ARCHITECTURE1 = 16,
    D3D12_FEATURE_D3D12_OPTIONS2 = 18,
    D3D12_FEATURE_SHADER_CACHE = 19,
    D3D12_FEATURE_COMMAND_QUEUE_PRIORITY = 20,
    D3D12_FEATURE_D3D12_OPTIONS3 = 21,
    D3D12_FEATURE_EXISTING_HEAPS = 22,
    D3D12_FEATURE_D3D12_OPTIONS4 = 23,
    D3D12_FEATURE_SERIALIZATION = 24,
    D3D12_FEATURE_CROSS_NODE = 25,
    D3D12_FEATURE_D3D12_OPTIONS5 = 27,
    D3D12_FEATURE_DISPLAYABLE = 0,
    D3D12_FEATURE_D3D12_OPTIONS6 = 30,
    D3D12_FEATURE_QUERY_META_COMMAND = 31,
    D3D12_FEATURE_D3D12_OPTIONS7 = 32,
    D3D12_FEATURE_PROTECTED_RESOURCE_SESSION_TYPE_COUNT = 33,
    D3D12_FEATURE_PROTECTED_RESOURCE_SESSION_TYPES = 34,
    D3D12_FEATURE_D3D12_OPTIONS8 = 36,
    D3D12_FEATURE_D3D12_OPTIONS9 = 37,
    D3D12_FEATURE_D3D12_OPTIONS10 = 0,
    D3D12_FEATURE_D3D12_OPTIONS11 = 0
} D3D12_FEATURE
```

## Constantes

| Constante | Descrição |
| - | - |
| D3D12\_FEATURE\_D3D12\_OPTIONS | Indica uma consulta sobre o nível de suporte às opções básicas de recursos do Direct3D 12. A estrutura de dados correspondente a esse valor é [D3D12\_FEATURE\_DATA\_D3D12\_OPTIONS](/pt-BR/reference/graphics/d3d12/structs/d3d12_feature_data_d3d12_options_public). |
| D3D12\_FEATURE\_ARCHITECTURE | Indica uma consulta sobre os detalhes de arquitetura do adaptador, para que seu aplicativo possa otimizar melhor para determinadas propriedades do adaptador. A estrutura de dados correspondente a esse valor é [D3D12\_FEATURE\_DATA\_ARCHITECTURE](/pt-BR/reference/graphics/d3d12/structs/d3d12_feature_data_architecture_public).  <div class="alert">**Observação**  Esse valor foi substituído pelo valor **D3D\_FEATURE\_DATA\_ARCHITECTURE1**. Se o seu aplicativo for destinado ao Windows 10, versão 1703 (Creators' Update) ou superior, use o valor **D3D\_FEATURE\_DATA\_ARCHITECTURE1**.</div> <div> </div> |
| D3D12\_FEATURE\_FEATURE\_LEVELS | Indica uma consulta sobre informações dos [níveis de recurso](https://learn.microsoft.com/en-us/windows/win32/direct3d11/overviews-direct3d-11-devices-downlevel-intro) com suporte. A estrutura de dados correspondente a esse valor é [D3D12\_FEATURE\_DATA\_FEATURE\_LEVELS](/pt-BR/reference/graphics/d3d12/structs/d3d12_feature_data_feature_levels_public). |
| D3D12\_FEATURE\_FORMAT\_SUPPORT | Indica uma consulta sobre os recursos com suporte pelo driver gráfico atual para um determinado formato. A estrutura de dados correspondente a esse valor é [D3D12\_FEATURE\_DATA\_FORMAT\_SUPPORT](/pt-BR/reference/graphics/d3d12/structs/d3d12_feature_data_format_support_public). |
| D3D12\_FEATURE\_MULTISAMPLE\_QUALITY\_LEVELS | Indica uma consulta sobre os níveis de qualidade de imagem para um determinado formato e contagem de amostras. A estrutura de dados correspondente a esse valor é [D3D12\_FEATURE\_DATA\_MULTISAMPLE\_QUALITY\_LEVELS](/pt-BR/reference/graphics/d3d12/structs/d3d12_feature_data_multisample_quality_levels_public). |
| D3D12\_FEATURE\_FORMAT\_INFO | Indica uma consulta sobre o formato de dados DXGI. A estrutura de dados correspondente a esse valor é [D3D12\_FEATURE\_DATA\_FORMAT\_INFO](/pt-BR/reference/graphics/d3d12/structs/d3d12_feature_data_format_info_public). |
| D3D12\_FEATURE\_GPU\_VIRTUAL\_ADDRESS\_SUPPORT | Indica uma consulta sobre as limitações do espaço de endereço virtual da GPU. A estrutura de dados correspondente a esse valor é [D3D12\_FEATURE\_DATA\_GPU\_VIRTUAL\_ADDRESS\_SUPPORT](/pt-BR/reference/graphics/d3d12/structs/d3d12_feature_data_gpu_virtual_address_support_public). |
| D3D12\_FEATURE\_SHADER\_MODEL | Indica uma consulta sobre o modelo de sombreador com suporte. A estrutura de dados correspondente a esse valor é [D3D12\_FEATURE\_DATA\_SHADER\_MODEL](/pt-BR/reference/graphics/d3d12/structs/d3d12_feature_data_shader_model_public). |
| D3D12\_FEATURE\_D3D12\_OPTIONS1 | Indica uma consulta sobre o nível de suporte às operações de onda do HLSL 6.0. A estrutura de dados correspondente a esse valor é [D3D12\_FEATURE\_DATA\_D3D12\_OPTIONS1](/pt-BR/reference/graphics/d3d12/structs/d3d12_feature_data_d3d12_options1_public). |
| D3D12\_FEATURE\_PROTECTED\_RESOURCE\_SESSION\_SUPPORT | Indica uma consulta sobre o nível de suporte a sessões de recursos protegidos. A estrutura de dados correspondente a esse valor é [D3D12\_FEATURE\_DATA\_PROTECTED\_RESOURCE\_SESSION\_SUPPORT](/pt-BR/reference/graphics/d3d12_x/structs/d3d12_feature_data_protected_resource_session_support). |
| D3D12\_FEATURE\_ROOT\_SIGNATURE | Indica uma consulta sobre o suporte à versão da assinatura raiz. A estrutura de dados correspondente a esse valor é [D3D12\_FEATURE\_DATA\_ROOT\_SIGNATURE](/pt-BR/reference/graphics/d3d12/structs/d3d12_feature_data_root_signature_public). |
| D3D12\_FEATURE\_ARCHITECTURE1 | Indica uma consulta sobre os detalhes de arquitetura de cada adaptador, para que seu aplicativo possa otimizar melhor para determinadas propriedades do adaptador. A estrutura de dados correspondente a esse valor é [D3D12\_FEATURE\_DATA\_ARCHITECTURE1](/pt-BR/reference/graphics/d3d12/structs/d3d12_feature_data_architecture1_public).  <div class="alert">**Observação**  Esse valor substitui o valor **D3D\_FEATURE\_DATA\_ARCHITECTURE**. Se o seu aplicativo for destinado ao Windows 10, versão 1703 (Creators' Update) ou superior, use **D3D\_FEATURE\_DATA\_ARCHITECTURE1**.</div> <div> </div> |
| D3D12\_FEATURE\_D3D12\_OPTIONS2 | Indica uma consulta sobre o nível de suporte a testes de limites de profundidade e posições de amostra programáveis. A estrutura de dados correspondente a esse valor é [D3D12\_FEATURE\_DATA\_D3D12\_OPTIONS2](/pt-BR/reference/graphics/d3d12/structs/d3d12_feature_data_d3d12_options2_public). |
| D3D12\_FEATURE\_SHADER\_CACHE | Indica uma consulta sobre o nível de suporte ao cache de sombreadores. A estrutura de dados correspondente a esse valor é [D3D12\_FEATURE\_DATA\_SHADER\_CACHE](/pt-BR/reference/graphics/d3d12/structs/d3d12_feature_data_shader_cache_public). |
| D3D12\_FEATURE\_COMMAND\_QUEUE\_PRIORITY | Indica uma consulta sobre o suporte do adaptador à priorização de diferentes tipos de fila de comandos. A estrutura de dados correspondente a esse valor é [D3D12\_FEATURE\_DATA\_COMMAND\_QUEUE\_PRIORITY](/pt-BR/reference/graphics/d3d12/structs/d3d12_feature_data_command_queue_priority_public). |
| D3D12\_FEATURE\_D3D12\_OPTIONS3 | Indica uma consulta sobre o nível de suporte a consultas de carimbo de data/hora, conversão de formato, gravação imediata, instanciação de exibição e baricêntricas. A estrutura de dados correspondente a esse valor é [D3D12\_FEATURE\_DATA\_D3D12\_OPTIONS3](/pt-BR/reference/graphics/d3d12/structs/d3d12_feature_data_d3d12_options3_public). |
| D3D12\_FEATURE\_EXISTING\_HEAPS | Indica uma consulta sobre se o adaptador oferece ou não suporte à criação de heaps a partir da memória do sistema existente. A estrutura de dados correspondente a esse valor é [D3D12\_FEATURE\_DATA\_EXISTING\_HEAPS](/pt-BR/reference/graphics/d3d12/structs/d3d12_feature_data_existing_heaps_public). |
| D3D12\_FEATURE\_D3D12\_OPTIONS4 | Indica uma consulta sobre o nível de suporte a texturas MSAA alinhadas em 64 KB, compartilhamento entre APIs e operações de sombreador nativas de 16 bits. A estrutura de dados correspondente a esse valor é [D3D12\_FEATURE\_DATA\_D3D12\_OPTIONS4](/pt-BR/reference/graphics/d3d12/structs/d3d12_feature_data_d3d12_options4_public). |
| D3D12\_FEATURE\_SERIALIZATION | Indica uma consulta sobre o nível de suporte à serialização de heap. A estrutura de dados correspondente a esse valor é [D3D12\_FEATURE\_DATA\_SERIALIZATION](/pt-BR/reference/graphics/d3d12/structs/d3d12_feature_data_serialization_public). |
| D3D12\_FEATURE\_CROSS\_NODE | Indica uma consulta sobre o nível de suporte ao compartilhamento de recursos entre diferentes adaptadores (por exemplo, várias GPUs). A estrutura de dados correspondente a esse valor é [D3D12\_FEATURE\_DATA\_CROSS\_NODE](/pt-BR/reference/graphics/d3d12/structs/d3d12_feature_data_cross_node_public). |
| D3D12\_FEATURE\_D3D12\_OPTIONS5 | A partir do Windows 10, versão 1809 (10.0; Build 17763), indica uma consulta sobre o nível de suporte a passagens de renderização, traçado de raios e recursos em blocos de camada 3 de exibição de recurso de sombreador. A estrutura de dados correspondente a esse valor é [D3D12\_FEATURE\_DATA\_D3D12\_OPTIONS5](/pt-BR/reference/graphics/d3d12/structs/d3d12_feature_data_d3d12_options5_public). |
| D3D12\_FEATURE\_DISPLAYABLE | A partir do Windows 11 (Build 10.0.22000.194). A estrutura de dados correspondente a esse valor é [D3D12\_FEATURE\_DATA\_DISPLAYABLE](/pt-BR/reference/graphics/d3d12_xs/structs/d3d12_feature_data_displayable_xs). |
| D3D12\_FEATURE\_D3D12\_OPTIONS6 | A partir do Windows 10, versão 1903 (10.0; Build 18362), indica uma consulta sobre o nível de suporte ao sombreamento de taxa variável (VRS) e indica se há ou não suporte ao processamento em segundo plano. A estrutura de dados correspondente a esse valor é [D3D12\_FEATURE\_DATA\_D3D12\_OPTIONS6](/pt-BR/reference/graphics/d3d12/structs/d3d12_feature_data_d3d12_options6_public).  Para obter mais informações, consulte [Sombreamento de taxa variável (VRS)](https://learn.microsoft.com/en-us/windows/win32/direct3d12/vrs) e a [especificação de processamento em segundo plano do Direct3D 12](https://microsoft.github.io/DirectX-Specs/d3d/BackgroundProcessing.html). |
| D3D12\_FEATURE\_QUERY\_META\_COMMAND | Indica uma consulta sobre o nível de suporte a metacomandos. A estrutura de dados correspondente a esse valor é [D3D12\_FEATURE\_DATA\_QUERY\_META\_COMMAND](/pt-BR/reference/graphics/d3d12/structs/d3d12_feature_data_query_meta_command_public). |
| D3D12\_FEATURE\_D3D12\_OPTIONS7 | A partir do Windows 10, versão 2004 (10.0; Build 19041), indica uma consulta sobre o nível de suporte a sombreadores de malha e de amplificação e a comentários do amostrador. A estrutura de dados correspondente a esse valor é [D3D12\_FEATURE\_DATA\_D3D12\_OPTIONS7](/pt-BR/reference/graphics/d3d12_xs/structs/d3d12_feature_data_d3d12_options7_xs).  Para obter mais informações, consulte as especificações de [Sombreador de malha](https://microsoft.github.io/DirectX-Specs/d3d/MeshShader.html) e de [Comentários do amostrador](https://microsoft.github.io/DirectX-Specs/d3d/SamplerFeedback.html). |
| D3D12\_FEATURE\_PROTECTED\_RESOURCE\_SESSION\_TYPE\_COUNT | A partir do Windows 10, versão 2004 (10.0; Build 19041), indica uma consulta para recuperar a contagem de tipos de sessão de recursos protegidos. A estrutura de dados correspondente a esse valor é [D3D12\_FEATURE\_DATA\_PROTECTED\_RESOURCE\_SESSION\_TYPE\_COUNT](/pt-BR/reference/graphics/d3d12_xs/structs/d3d12_feature_data_protected_resource_session_type_count_xs). |
| D3D12\_FEATURE\_PROTECTED\_RESOURCE\_SESSION\_TYPES | A partir do Windows 10, versão 2004 (10.0; Build 19041), indica uma consulta para recuperar a lista de tipos de sessão de recursos protegidos. A estrutura de dados correspondente a esse valor é [D3D12\_FEATURE\_DATA\_PROTECTED\_RESOURCE\_SESSION\_TYPES](/pt-BR/reference/graphics/d3d12_xs/structs/d3d12_feature_data_protected_resource_session_types_xs). |
| D3D12\_FEATURE\_D3D12\_OPTIONS8 | A partir do Windows 11 (Build 10.0.22000.194), indica se há ou não suporte a texturas compactadas em blocos não alinhadas. A estrutura de dados correspondente a esse valor é [D3D12\_FEATURE\_DATA\_D3D12\_OPTIONS8](/pt-BR/reference/graphics/d3d12_xs/structs/d3d12_feature_data_d3d12_options8_xs). |
| D3D12\_FEATURE\_D3D12\_OPTIONS9 | A partir do Windows 11 (Build 10.0.22000.194), indica se há ou não suporte a sombreadores de malha, valores de *SV\_RenderTargetArrayIndex* iguais a 8 ou superiores, atômicos de inteiros de 64 bits em recursos tipados, operações de amostragem de textura derivativas e dependentes de derivativas, e o nível de suporte a operações WaveMMA (wave\_matrix). A estrutura de dados correspondente a esse valor é [D3D12\_FEATURE\_DATA\_D3D12\_OPTIONS9](/pt-BR/reference/graphics/d3d12_xs/structs/d3d12_feature_data_d3d12_options9_xs). |
| D3D12\_FEATURE\_D3D12\_OPTIONS10 | A partir do Windows 11 (Build 10.0.22000.194), indica se o combinador SUM pode ou não ser usado e se *SV\_ShadingRate* pode ou não ser definido a partir de um sombreador de malha. A estrutura de dados correspondente a esse valor é [D3D12\_FEATURE\_DATA\_D3D12\_OPTIONS10](/pt-BR/reference/graphics/d3d12_xs/structs/d3d12_feature_data_d3d12_options10_xs). |
| D3D12\_FEATURE\_D3D12\_OPTIONS11 | A partir do Windows 11 (Build 10.0.22000.194), indica se há ou não suporte a atômicos de inteiros de 64 bits em recursos em heaps de descritores. A estrutura de dados correspondente a esse valor é [D3D12\_FEATURE\_DATA\_D3D12\_OPTIONS11](/pt-BR/reference/graphics/d3d12_xs/structs/d3d12_feature_data_d3d12_options11_xs). |

## Comentários

Use uma constante desta enumeração em uma chamada para [ID3D12Device::CheckFeatureSupport](/pt-BR/reference/graphics/d3d12/interfaces/id3d12device/methods/id3d12device_checkfeaturesupport_public) para consultar um driver sobre o suporte a vários recursos do Direct3D 12. Cada valor nesta enumeração tem uma estrutura de dados correspondente que você deve passar (por referência de ponteiro) no parâmetro *pFeatureSupportData* de **ID3D12Device::CheckFeatureSupport**.

## Requisitos

**Cabeçalho:** d3d12\_xs.h ou d3d12\_x.h\
**Biblioteca:** d3d12\_xs.lib ou d3d12\_x.lib\
**Plataformas com suporte**: consoles XBOX Series e família XBOX One

## Confira também

* [Enumerações principais](https://learn.microsoft.com/en-us/windows/win32/direct3d12/direct3d-12-enumerations)
* [ID3D12Device::CheckFeatureSupport](/pt-BR/reference/graphics/d3d12/interfaces/id3d12device/methods/id3d12device_checkfeaturesupport_public)


## Related topics

- [D3D12_FEATURE_DATA_D3D12_OPTIONS](/pt-BR/reference/graphics/d3d12/structs/d3d12_feature_data_d3d12_options_public.md)
- [D3D12_FEATURE_DATA_D3D12_OPTIONS2](/pt-BR/reference/graphics/d3d12/structs/d3d12_feature_data_d3d12_options2_public.md)
- [D3D12_FEATURE_DATA_D3D12_OPTIONS5](/pt-BR/reference/graphics/d3d12/structs/d3d12_feature_data_d3d12_options5_public.md)
- [D3D12_FEATURE_DATA_D3D12_OPTIONS1](/pt-BR/reference/graphics/d3d12/structs/d3d12_feature_data_d3d12_options1_public.md)
- [D3D12_FEATURE_DATA_D3D12_OPTIONS3](/pt-BR/reference/graphics/d3d12/structs/d3d12_feature_data_d3d12_options3_public.md)
