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

> 설명자 범위를 설명합니다.

설명자 범위를 설명합니다.

## 구문

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

### 멤버

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

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

*NumDescriptors*\
형식: UINT

범위의 설명자 수입니다. 제한 없는 크기를 지정하려면 -1 또는 UINT\_MAX를 사용합니다. 지정된 설명자 범위가 제한 없는 경우 이는 테이블 정의의 마지막 범위이거나, 그렇지 않으면 테이블 정의의 다음 범위에 **D3D12\_DESCRIPTOR\_RANGE\_OFFSET\_APPEND**가 아닌 *OffsetInDescriptorsFromTableStart* 값이 있어야 합니다.

*BaseShaderRegister*\
형식: UINT

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

*RegisterSpace*\
형식: UINT

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

*OffsetInDescriptorsFromTableStart*\
형식: UINT

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

## 설명

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

## 요구 사항

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

## 관련 항목

[CD3DX12\_DESCRIPTOR\_RANGE](https://learn.microsoft.com/en-us/windows/desktop/direct3d12/cd3dx12-descriptor-range)

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


## Related topics

- [D3D12_DESCRIPTOR_RANGE_TYPE](/ko/reference/graphics/d3d12/enums/d3d12_descriptor_range_type_public.md)
- [D3D12_ROOT_DESCRIPTOR_TABLE](/ko/reference/graphics/d3d12/structs/d3d12_root_descriptor_table_public.md)
- [D3D12_DESCRIPTOR_RANGE_FLAGS](/ko/reference/graphics/d3d12/enums/d3d12_descriptor_range_flags_public.md)
- [D3D12_DESCRIPTOR_RANGE1](/ko/reference/graphics/d3d12/structs/d3d12_descriptor_range1_public.md)
- [D3D12_ROOT_DESCRIPTOR_FLAGS](/ko/reference/graphics/d3d12/enums/d3d12_root_descriptor_flags_public.md)