> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# D3D12_FEATURE

> 쿼리할 Direct3D 12 기능 또는 기능 세트를 지정하는 상수를 정의합니다.

쿼리할 Direct3D 12 기능 또는 기능 세트를 지정하는 상수를 정의합니다. 어댑터가 기능을 지원하는 수준을 쿼리하려면 이 값 중 하나를 [ID3D12Device::CheckFeatureSupport](https://docs.xbox.com/ko/reference/graphics/d3d12/interfaces/id3d12device/methods/id3d12device_checkfeaturesupport_public.md)에 전달합니다.

## 구문

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

## 상수

| 상수 | 설명 |
| - | - |
| D3D12\_FEATURE\_D3D12\_OPTIONS | 기본 Direct3D 12 기능 옵션에 대한 지원 수준 쿼리를 나타냅니다. 이 값에 해당하는 데이터 구조체는 [D3D12\_FEATURE\_DATA\_D3D12\_OPTIONS](https://docs.xbox.com/ko/reference/graphics/d3d12/structs/d3d12_feature_data_d3d12_options_public.md)입니다. |
| D3D12\_FEATURE\_ARCHITECTURE | 애플리케이션이 특정 어댑터 속성에 대해 더 잘 최적화할 수 있도록 어댑터의 아키텍처 세부 정보에 대한 쿼리를 나타냅니다. 이 값에 해당하는 데이터 구조체는 [D3D12\_FEATURE\_DATA\_ARCHITECTURE](https://docs.xbox.com/ko/reference/graphics/d3d12/structs/d3d12_feature_data_architecture_public.md)입니다.  **참고**  이 값은 **D3D\_FEATURE\_DATA\_ARCHITECTURE1** 값으로 대체되었습니다. 애플리케이션이 Windows 10 버전 1703(Creators' Update) 이상을 대상으로 하는 경우 대신 **D3D\_FEATURE\_DATA\_ARCHITECTURE1** 값을 사용하세요.   |
| D3D12\_FEATURE\_FEATURE\_LEVELS | 지원되는 [기능 수준](https://learn.microsoft.com/en-us/windows/win32/direct3d11/overviews-direct3d-11-devices-downlevel-intro)에 대한 정보 쿼리를 나타냅니다. 이 값에 해당하는 데이터 구조체는 [D3D12\_FEATURE\_DATA\_FEATURE\_LEVELS](https://docs.xbox.com/ko/reference/graphics/d3d12/structs/d3d12_feature_data_feature_levels_public.md)입니다. |
| D3D12\_FEATURE\_FORMAT\_SUPPORT | 지정된 형식에 대해 현재 그래픽 드라이버가 지원하는 리소스에 대한 쿼리를 나타냅니다. 이 값에 해당하는 데이터 구조체는 [D3D12\_FEATURE\_DATA\_FORMAT\_SUPPORT](https://docs.xbox.com/ko/reference/graphics/d3d12/structs/d3d12_feature_data_format_support_public.md)입니다. |
| D3D12\_FEATURE\_MULTISAMPLE\_QUALITY\_LEVELS | 지정된 형식 및 샘플 개수에 대한 이미지 품질 수준 쿼리를 나타냅니다. 이 값에 해당하는 데이터 구조체는 [D3D12\_FEATURE\_DATA\_MULTISAMPLE\_QUALITY\_LEVELS](https://docs.xbox.com/ko/reference/graphics/d3d12/structs/d3d12_feature_data_multisample_quality_levels_public.md)입니다. |
| D3D12\_FEATURE\_FORMAT\_INFO | DXGI 데이터 형식에 대한 쿼리를 나타냅니다. 이 값에 해당하는 데이터 구조체는 [D3D12\_FEATURE\_DATA\_FORMAT\_INFO](https://docs.xbox.com/ko/reference/graphics/d3d12/structs/d3d12_feature_data_format_info_public.md)입니다. |
| D3D12\_FEATURE\_GPU\_VIRTUAL\_ADDRESS\_SUPPORT | GPU의 가상 주소 공간 제한에 대한 쿼리를 나타냅니다. 이 값에 해당하는 데이터 구조체는 [D3D12\_FEATURE\_DATA\_GPU\_VIRTUAL\_ADDRESS\_SUPPORT](https://docs.xbox.com/ko/reference/graphics/d3d12/structs/d3d12_feature_data_gpu_virtual_address_support_public.md)입니다. |
| D3D12\_FEATURE\_SHADER\_MODEL | 지원되는 셰이더 모델에 대한 쿼리를 나타냅니다. 이 값에 해당하는 데이터 구조체는 [D3D12\_FEATURE\_DATA\_SHADER\_MODEL](https://docs.xbox.com/ko/reference/graphics/d3d12/structs/d3d12_feature_data_shader_model_public.md)입니다. |
| D3D12\_FEATURE\_D3D12\_OPTIONS1 | HLSL 6.0 웨이브 작업에 대한 지원 수준 쿼리를 나타냅니다. 이 값에 해당하는 데이터 구조체는 [D3D12\_FEATURE\_DATA\_D3D12\_OPTIONS1](https://docs.xbox.com/ko/reference/graphics/d3d12/structs/d3d12_feature_data_d3d12_options1_public.md)입니다. |
| D3D12\_FEATURE\_PROTECTED\_RESOURCE\_SESSION\_SUPPORT | 보호된 리소스 세션에 대한 지원 수준 쿼리를 나타냅니다. 이 값에 해당하는 데이터 구조체는 [D3D12\_FEATURE\_DATA\_PROTECTED\_RESOURCE\_SESSION\_SUPPORT](https://docs.xbox.com/ko/reference/graphics/d3d12_x/structs/d3d12_feature_data_protected_resource_session_support.md)입니다. |
| D3D12\_FEATURE\_ROOT\_SIGNATURE | 루트 서명 버전 지원에 대한 쿼리를 나타냅니다. 이 값에 해당하는 데이터 구조체는 [D3D12\_FEATURE\_DATA\_ROOT\_SIGNATURE](https://docs.xbox.com/ko/reference/graphics/d3d12/structs/d3d12_feature_data_root_signature_public.md)입니다. |
| D3D12\_FEATURE\_ARCHITECTURE1 | 애플리케이션이 특정 어댑터 속성에 대해 더 잘 최적화할 수 있도록 각 어댑터의 아키텍처 세부 정보에 대한 쿼리를 나타냅니다. 이 값에 해당하는 데이터 구조체는 [D3D12\_FEATURE\_DATA\_ARCHITECTURE1](https://docs.xbox.com/ko/reference/graphics/d3d12/structs/d3d12_feature_data_architecture1_public.md)입니다.  **참고**  이 값은 **D3D\_FEATURE\_DATA\_ARCHITECTURE** 값을 대체합니다. 애플리케이션이 Windows 10 버전 1703(Creators' Update) 이상을 대상으로 하는 경우 **D3D\_FEATURE\_DATA\_ARCHITECTURE1**을 사용하세요.   |
| D3D12\_FEATURE\_D3D12\_OPTIONS2 | 깊이 경계 테스트 및 프로그래밍 가능한 샘플 위치에 대한 지원 수준 쿼리를 나타냅니다. 이 값에 해당하는 데이터 구조체는 [D3D12\_FEATURE\_DATA\_D3D12\_OPTIONS2](https://docs.xbox.com/ko/reference/graphics/d3d12/structs/d3d12_feature_data_d3d12_options2_public.md)입니다. |
| D3D12\_FEATURE\_SHADER\_CACHE | 셰이더 캐싱에 대한 지원 수준 쿼리를 나타냅니다. 이 값에 해당하는 데이터 구조체는 [D3D12\_FEATURE\_DATA\_SHADER\_CACHE](https://docs.xbox.com/ko/reference/graphics/d3d12/structs/d3d12_feature_data_shader_cache_public.md)입니다. |
| D3D12\_FEATURE\_COMMAND\_QUEUE\_PRIORITY | 다양한 명령 큐 형식의 우선순위 지정에 대한 어댑터의 지원 쿼리를 나타냅니다. 이 값에 해당하는 데이터 구조체는 [D3D12\_FEATURE\_DATA\_COMMAND\_QUEUE\_PRIORITY](https://docs.xbox.com/ko/reference/graphics/d3d12/structs/d3d12_feature_data_command_queue_priority_public.md)입니다. |
| D3D12\_FEATURE\_D3D12\_OPTIONS3 | 타임스탬프 쿼리, 형식 캐스팅, 즉시 쓰기, 뷰 인스턴싱 및 무게중심 좌표(barycentrics)에 대한 지원 수준 쿼리를 나타냅니다. 이 값에 해당하는 데이터 구조체는 [D3D12\_FEATURE\_DATA\_D3D12\_OPTIONS3](https://docs.xbox.com/ko/reference/graphics/d3d12/structs/d3d12_feature_data_d3d12_options3_public.md)입니다. |
| D3D12\_FEATURE\_EXISTING\_HEAPS | 어댑터가 기존 시스템 메모리에서 힙을 만드는 것을 지원하는지 여부에 대한 쿼리를 나타냅니다. 이 값에 해당하는 데이터 구조체는 [D3D12\_FEATURE\_DATA\_EXISTING\_HEAPS](https://docs.xbox.com/ko/reference/graphics/d3d12/structs/d3d12_feature_data_existing_heaps_public.md)입니다. |
| D3D12\_FEATURE\_D3D12\_OPTIONS4 | 64KB로 정렬된 MSAA 텍스처, 크로스 API 공유 및 네이티브 16비트 셰이더 작업에 대한 지원 수준 쿼리를 나타냅니다. 이 값에 해당하는 데이터 구조체는 [D3D12\_FEATURE\_DATA\_D3D12\_OPTIONS4](https://docs.xbox.com/ko/reference/graphics/d3d12/structs/d3d12_feature_data_d3d12_options4_public.md)입니다. |
| D3D12\_FEATURE\_SERIALIZATION | 힙 직렬화에 대한 지원 수준 쿼리를 나타냅니다. 이 값에 해당하는 데이터 구조체는 [D3D12\_FEATURE\_DATA\_SERIALIZATION](https://docs.xbox.com/ko/reference/graphics/d3d12/structs/d3d12_feature_data_serialization_public.md)입니다. |
| D3D12\_FEATURE\_CROSS\_NODE | 서로 다른 어댑터 간의 리소스 공유(예: 여러 GPU) 지원 수준 쿼리를 나타냅니다. 이 값에 해당하는 데이터 구조체는 [D3D12\_FEATURE\_DATA\_CROSS\_NODE](https://docs.xbox.com/ko/reference/graphics/d3d12/structs/d3d12_feature_data_cross_node_public.md)입니다. |
| D3D12\_FEATURE\_D3D12\_OPTIONS5 | Windows 10 버전 1809(10.0; 빌드 17763)부터, 렌더 패스, 레이 트레이싱, 셰이더 리소스 뷰 티어 3 타일 리소스에 대한 지원 수준 쿼리를 나타냅니다. 이 값에 해당하는 데이터 구조체는 [D3D12\_FEATURE\_DATA\_D3D12\_OPTIONS5](https://docs.xbox.com/ko/reference/graphics/d3d12/structs/d3d12_feature_data_d3d12_options5_public.md)입니다. |
| D3D12\_FEATURE\_DISPLAYABLE | Windows 11(빌드 10.0.22000.194)부터 사용 가능합니다. 이 값에 해당하는 데이터 구조체는 [D3D12\_FEATURE\_DATA\_DISPLAYABLE](https://docs.xbox.com/ko/reference/graphics/d3d12_xs/structs/d3d12_feature_data_displayable_xs.md)입니다. |
| D3D12\_FEATURE\_D3D12\_OPTIONS6 | Windows 10 버전 1903(10.0; 빌드 18362)부터, 가변 속도 셰이딩(VRS)에 대한 지원 수준 쿼리를 나타내며, 백그라운드 처리가 지원되는지 여부를 나타냅니다. 이 값에 해당하는 데이터 구조체는 [D3D12\_FEATURE\_DATA\_D3D12\_OPTIONS6](https://docs.xbox.com/ko/reference/graphics/d3d12/structs/d3d12_feature_data_d3d12_options6_public.md)입니다. 자세한 내용은 [가변 속도 셰이딩(VRS)](https://learn.microsoft.com/en-us/windows/win32/direct3d12/vrs)과 [Direct3D 12 백그라운드 처리 사양](https://microsoft.github.io/DirectX-Specs/d3d/BackgroundProcessing.html)을 참조하세요. |
| D3D12\_FEATURE\_QUERY\_META\_COMMAND | 메타 명령에 대한 지원 수준 쿼리를 나타냅니다. 이 값에 해당하는 데이터 구조체는 [D3D12\_FEATURE\_DATA\_QUERY\_META\_COMMAND](https://docs.xbox.com/ko/reference/graphics/d3d12/structs/d3d12_feature_data_query_meta_command_public.md)입니다. |
| D3D12\_FEATURE\_D3D12\_OPTIONS7 | Windows 10 버전 2004(10.0; 빌드 19041)부터, 메시 및 증폭 셰이더와 샘플러 피드백에 대한 지원 수준 쿼리를 나타냅니다. 이 값에 해당하는 데이터 구조체는 [D3D12\_FEATURE\_DATA\_D3D12\_OPTIONS7](https://docs.xbox.com/ko/reference/graphics/d3d12_xs/structs/d3d12_feature_data_d3d12_options7_xs.md)입니다. 자세한 내용은 [메시 셰이더](https://microsoft.github.io/DirectX-Specs/d3d/MeshShader.html) 및 [샘플러 피드백](https://microsoft.github.io/DirectX-Specs/d3d/SamplerFeedback.html) 사양을 참조하세요. |
| D3D12\_FEATURE\_PROTECTED\_RESOURCE\_SESSION\_TYPE\_COUNT | Windows 10 버전 2004(10.0; 빌드 19041)부터, 보호된 리소스 세션 형식의 개수를 검색하는 쿼리를 나타냅니다. 이 값에 해당하는 데이터 구조체는 [D3D12\_FEATURE\_DATA\_PROTECTED\_RESOURCE\_SESSION\_TYPE\_COUNT](https://docs.xbox.com/ko/reference/graphics/d3d12_xs/structs/d3d12_feature_data_protected_resource_session_type_count_xs.md)입니다. |
| D3D12\_FEATURE\_PROTECTED\_RESOURCE\_SESSION\_TYPES | Windows 10 버전 2004(10.0; 빌드 19041)부터, 보호된 리소스 세션 형식 목록을 검색하는 쿼리를 나타냅니다. 이 값에 해당하는 데이터 구조체는 [D3D12\_FEATURE\_DATA\_PROTECTED\_RESOURCE\_SESSION\_TYPES](https://docs.xbox.com/ko/reference/graphics/d3d12_xs/structs/d3d12_feature_data_protected_resource_session_types_xs.md)입니다. |
| D3D12\_FEATURE\_D3D12\_OPTIONS8 | Windows 11(빌드 10.0.22000.194)부터, 정렬되지 않은 블록 압축 텍스처가 지원되는지 여부를 나타냅니다. 이 값에 해당하는 데이터 구조체는 [D3D12\_FEATURE\_DATA\_D3D12\_OPTIONS8](https://docs.xbox.com/ko/reference/graphics/d3d12_xs/structs/d3d12_feature_data_d3d12_options8_xs.md)입니다. |
| D3D12\_FEATURE\_D3D12\_OPTIONS9 | Windows 11(빌드 10.0.22000.194)부터, 메시 셰이더, 8 이상의 *SV\_RenderTargetArrayIndex* 값, 형식 지정된 리소스 64비트 정수 원자적 연산, 미분 및 미분 종속 텍스처 샘플 작업 지원 여부와 WaveMMA(wave\_matrix) 작업에 대한 지원 수준을 나타냅니다. 이 값에 해당하는 데이터 구조체는 [D3D12\_FEATURE\_DATA\_D3D12\_OPTIONS9](https://docs.xbox.com/ko/reference/graphics/d3d12_xs/structs/d3d12_feature_data_d3d12_options9_xs.md)입니다. |
| D3D12\_FEATURE\_D3D12\_OPTIONS10 | Windows 11(빌드 10.0.22000.194)부터, SUM 결합자를 사용할 수 있는지 여부와 메시 셰이더에서 *SV\_ShadingRate*를 설정할 수 있는지 여부를 나타냅니다. 이 값에 해당하는 데이터 구조체는 [D3D12\_FEATURE\_DATA\_D3D12\_OPTIONS10](https://docs.xbox.com/ko/reference/graphics/d3d12_xs/structs/d3d12_feature_data_d3d12_options10_xs.md)입니다. |
| D3D12\_FEATURE\_D3D12\_OPTIONS11 | Windows 11(빌드 10.0.22000.194)부터, 설명자 힙의 리소스에 대한 64비트 정수 원자적 연산이 지원되는지 여부를 나타냅니다. 이 값에 해당하는 데이터 구조체는 [D3D12\_FEATURE\_DATA\_D3D12\_OPTIONS11](https://docs.xbox.com/ko/reference/graphics/d3d12_xs/structs/d3d12_feature_data_d3d12_options11_xs.md)입니다. |

## 설명

[ID3D12Device::CheckFeatureSupport](https://docs.xbox.com/ko/reference/graphics/d3d12/interfaces/id3d12device/methods/id3d12device_checkfeaturesupport_public.md) 호출에서 이 열거형의 상수를 사용하여 다양한 Direct3D 12 기능에 대한 드라이버의 지원을 쿼리합니다. 이 열거형의 각 값에는 **ID3D12Device::CheckFeatureSupport**의 *pFeatureSupportData* 매개 변수에 (포인터 참조로) 전달해야 하는 해당 데이터 구조체가 있습니다.

## 요구 사항

**헤더:** d3d12\_xs.h 또는 d3d12\_x.h\
**라이브러리:** d3d12\_xs.lib 또는 d3d12\_x.lib\
**지원 플랫폼**: XBOX Series 콘솔 및 XBOX One 제품군

## 함께 보기

* [핵심 열거형](https://learn.microsoft.com/en-us/windows/win32/direct3d12/direct3d-12-enumerations)
* [ID3D12Device::CheckFeatureSupport](https://docs.xbox.com/ko/reference/graphics/d3d12/interfaces/id3d12device/methods/id3d12device_checkfeaturesupport_public.md)


## Related topics

- [D3D12_FEATURE_DATA_D3D12_OPTIONS](https://docs.xbox.com/ko/reference/graphics/d3d12/structs/d3d12_feature_data_d3d12_options_public.md)
- [D3D12_FEATURE_DATA_D3D12_OPTIONS2](https://docs.xbox.com/ko/reference/graphics/d3d12/structs/d3d12_feature_data_d3d12_options2_public.md)
- [D3D12_FEATURE_DATA_D3D12_OPTIONS5](https://docs.xbox.com/ko/reference/graphics/d3d12/structs/d3d12_feature_data_d3d12_options5_public.md)
- [D3D12_FEATURE_DATA_D3D12_OPTIONS1](https://docs.xbox.com/ko/reference/graphics/d3d12/structs/d3d12_feature_data_d3d12_options1_public.md)
- [D3D12_FEATURE_DATA_D3D12_OPTIONS3](https://docs.xbox.com/ko/reference/graphics/d3d12/structs/d3d12_feature_data_d3d12_options3_public.md)
