> ## 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](/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](/zh-CN/reference/graphics/d3d12/structs/d3d12_root_descriptor_table1_public.md)
- [D3D12_DESCRIPTOR_RANGE_FLAGS](/zh-CN/reference/graphics/d3d12/enums/d3d12_descriptor_range_flags_public.md)
- [D3D12_ROOT_DESCRIPTOR_TABLE](/zh-CN/reference/graphics/d3d12/structs/d3d12_root_descriptor_table_public.md)
- [D3D12_FEATURE_DATA_ARCHITECTURE1](/zh-CN/reference/graphics/d3d12/structs/d3d12_feature_data_architecture1_public.md)
- [D3D12_ROOT_DESCRIPTOR](/zh-CN/reference/graphics/d3d12/structs/d3d12_root_descriptor_public.md)