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

> 描述描述元範圍，並包含用於判斷其變動性的旗標。

描述描述元範圍，並包含用於判斷其變動性的旗標。

## 語法

```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](/zh-TW/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](/zh-TW/reference/graphics/d3d12/enums/d3d12_descriptor_range_flags_public)。

*OffsetInDescriptorsFromTableStart*\
類型：UINT

從根簽章開頭起算的位移 (以描述元為單位)。此值可以是 **D3D12\_DESCRIPTOR\_RANGE\_OFFSET\_APPEND**，表示此範圍應緊接在前一個範圍之後。

## 備註

此結構是 [D3D12\_ROOT\_DESCRIPTOR\_TABLE1](/zh-TW/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](/zh-TW/reference/graphics/d3d12/structs/d3d12_root_descriptor_table1_public.md)
- [D3D12_DESCRIPTOR_RANGE_FLAGS](/zh-TW/reference/graphics/d3d12/enums/d3d12_descriptor_range_flags_public.md)
- [D3D12_ROOT_DESCRIPTOR_TABLE](/zh-TW/reference/graphics/d3d12/structs/d3d12_root_descriptor_table_public.md)
- [D3D12_FEATURE_DATA_ARCHITECTURE1](/zh-TW/reference/graphics/d3d12/structs/d3d12_feature_data_architecture1_public.md)
- [D3D12_ROOT_DESCRIPTOR](/zh-TW/reference/graphics/d3d12/structs/d3d12_root_descriptor_public.md)