> ## 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](/zh-TW/reference/graphics/d3d12/enums/d3d12_descriptor_range_type_public) 類型的值，指定描述元範圍的類型。

*NumDescriptors*\
類型：UINT

範圍中的描述元數目。使用 -1 或 UINT\_MAX 指定無限制的大小。如果指定的描述元範圍為無限制，則它必須是資料表定義中的最後一個範圍，否則資料表定義中的下一個範圍其 *OffsetInDescriptorsFromTableStart* 值必須不是 **D3D12\_DESCRIPTOR\_RANGE\_OFFSET\_APPEND**。

*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](/zh-TW/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](/zh-TW/reference/graphics/d3d12/enums/d3d12_descriptor_range_type_public.md)
- [D3D12_ROOT_DESCRIPTOR_TABLE](/zh-TW/reference/graphics/d3d12/structs/d3d12_root_descriptor_table_public.md)
- [D3D12_DESCRIPTOR_RANGE_FLAGS](/zh-TW/reference/graphics/d3d12/enums/d3d12_descriptor_range_flags_public.md)
- [D3D12_DESCRIPTOR_RANGE1](/zh-TW/reference/graphics/d3d12/structs/d3d12_descriptor_range1_public.md)
- [D3D12_ROOT_DESCRIPTOR_FLAGS](/zh-TW/reference/graphics/d3d12/enums/d3d12_root_descriptor_flags_public.md)