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

> 설명자 범위를 설명하며, 휘발성(volatility)을 결정하는 플래그를 함께 지정합니다.

설명자 범위를 설명하며, 휘발성(volatility)을 결정하는 플래그를 함께 지정합니다.

## 구문

```cpp theme={null}
typedef struct D3D12_DESCRIPTOR_RANGE1
{
    D3D12_DESCRIPTOR_RANGE_TYPE RangeType;
    UINT NumDescriptors;
    UINT BaseShaderRegister;
    UINT RegisterSpace;
    D3D12_DESCRIPTOR_RANGE_FLAGS Flags;
    UINT OffsetInDescriptorsFromTableStart;
} D3D12_DESCRIPTOR_RANGE1
```

### 멤버

*RangeType*\
형식: D3D12\_DESCRIPTOR\_RANGE\_TYPE

설명자 범위의 형식을 지정하는 [D3D12\_DESCRIPTOR\_RANGE\_TYPE](/reference/graphics/d3d12/enums/d3d12_descriptor_range_type_public) 형식의 값입니다.

*NumDescriptors*\
형식: UINT

범위의 설명자 수입니다. 제한 없는 크기를 지정하려면 -1 또는 UINT\_MAX를 사용합니다. 테이블의 마지막 항목만 제한 없는 크기를 가질 수 있습니다.

*BaseShaderRegister*\
형식: UINT

범위의 기본 셰이더 레지스터입니다. 예를 들어, 셰이더 리소스 뷰(SRV)의 경우 3은 HLSL의 ": register(t3);"에 매핑됩니다.

*RegisterSpace*\
형식: UINT

레지스터 공간입니다. 일반적으로 0일 수 있지만, 크기를 알 수 없는 여러 설명자 배열이 겹치지 않도록 허용합니다.
예를 들어, SRV의 경우 **BaseShaderRegister** 멤버 설명의 예를 확장하면 5는 HLSL의 ": register(t3,space5);"에 매핑됩니다.

*Flags*\
형식: D3D12\_DESCRIPTOR\_RANGE\_FLAGS

설명자 및 데이터 휘발성을 결정하는 [D3D12\_DESCRIPTOR\_RANGE\_FLAGS](/reference/graphics/d3d12/enums/d3d12_descriptor_range_flags_public)를 지정합니다.

*OffsetInDescriptorsFromTableStart*\
형식: UINT

루트 시그니처 시작부터의 설명자 오프셋입니다. 이 값은 **D3D12\_DESCRIPTOR\_RANGE\_OFFSET\_APPEND**일 수 있으며, 이는 이 범위가 이전 범위 바로 뒤에 이어져야 함을 나타냅니다.

## 설명

이 구조체는 [D3D12\_ROOT\_DESCRIPTOR\_TABLE1](/reference/graphics/d3d12/structs/d3d12_root_descriptor_table1_public) 구조체의 멤버입니다.

헬퍼 구조체 [CD3DX12\_DESCRIPTOR\_RANGE1](https://learn.microsoft.com/en-us/windows/desktop/direct3d12/cd3dx12-descriptor-range1)을 참조하세요.

## 요구 사항

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

## 관련 항목

[핵심 구조체](https://learn.microsoft.com/en-us/windows/desktop/direct3d12/direct3d-12-structures)

[루트 시그니처 버전 1.1](https://learn.microsoft.com/en-us/windows/desktop/direct3d12/root-signature-version-1-1)


## Related topics

- [D3D12_ROOT_DESCRIPTOR_TABLE1](/ko/reference/graphics/d3d12/structs/d3d12_root_descriptor_table1_public.md)
- [D3D12_DESCRIPTOR_RANGE_FLAGS](/ko/reference/graphics/d3d12/enums/d3d12_descriptor_range_flags_public.md)
- [D3D12_ROOT_DESCRIPTOR_TABLE](/ko/reference/graphics/d3d12/structs/d3d12_root_descriptor_table_public.md)
- [D3D12_FEATURE_DATA_ARCHITECTURE1](/ko/reference/graphics/d3d12/structs/d3d12_feature_data_architecture1_public.md)
- [D3D12_ROOT_DESCRIPTOR](/ko/reference/graphics/d3d12/structs/d3d12_root_descriptor_public.md)