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

> Descreve um intervalo de descritores, com sinalizadores para determinar sua volatilidade.

Descreve um intervalo de descritores, com sinalizadores para determinar sua volatilidade.

## Sintaxe

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

### Membros

*RangeType*\
Tipo: D3D12\_DESCRIPTOR\_RANGE\_TYPE

Um valor do tipo [D3D12\_DESCRIPTOR\_RANGE\_TYPE](https://devdocs.xbox.com/pt-BR/reference/graphics/d3d12/enums/d3d12_descriptor_range_type_public.md) que especifica o tipo de intervalo de descritores.

*NumDescriptors*\
Tipo: UINT

O número de descritores no intervalo. Use -1 ou UINT\_MAX para especificar um tamanho ilimitado. Somente a última entrada de uma tabela pode ter tamanho ilimitado.

*BaseShaderRegister*\
Tipo: UINT

O registro de sombreador base no intervalo. Por exemplo, para exibições de recurso de sombreador (SRVs), 3 é mapeado para ": register(t3);" em HLSL.

*RegisterSpace*\
Tipo: UINT

O espaço de registro. Normalmente pode ser 0, mas permite que várias matrizes de descritores de tamanho desconhecido não pareçam se sobrepor.
Por exemplo, para SRVs, estendendo o exemplo na descrição do membro **BaseShaderRegister**, 5 é mapeado para ": register(t3,space5);" em HLSL.

*Flags*\
Tipo: D3D12\_DESCRIPTOR\_RANGE\_FLAGS

Especifica os [D3D12\_DESCRIPTOR\_RANGE\_FLAGS](https://devdocs.xbox.com/pt-BR/reference/graphics/d3d12/enums/d3d12_descriptor_range_flags_public.md) que determinam a volatilidade dos descritores e dos dados.

*OffsetInDescriptorsFromTableStart*\
Tipo: UINT

O deslocamento, em descritores, a partir do início da assinatura raiz. Esse valor pode ser **D3D12\_DESCRIPTOR\_RANGE\_OFFSET\_APPEND**, o que indica que este intervalo deve vir imediatamente após o intervalo anterior.

## Comentários

Esta estrutura é membro da estrutura [D3D12\_ROOT\_DESCRIPTOR\_TABLE1](https://devdocs.xbox.com/pt-BR/reference/graphics/d3d12/structs/d3d12_root_descriptor_table1_public.md).

Consulte a estrutura auxiliar [CD3DX12\_DESCRIPTOR\_RANGE1](https://learn.microsoft.com/en-us/windows/desktop/direct3d12/cd3dx12-descriptor-range1).

## Requisitos

**Cabeçalho:** d3d12\_xs.h ou d3d12\_x.h\
**Biblioteca:** d3d12\_xs.lib ou d3d12\_x.lib\
**Plataformas com suporte**: consoles XBOX Series e família XBOX One

## Confira também

[Estruturas principais](https://learn.microsoft.com/en-us/windows/desktop/direct3d12/direct3d-12-structures)

[Assinatura raiz versão 1.1](https://learn.microsoft.com/en-us/windows/desktop/direct3d12/root-signature-version-1-1)


## Related topics

- [D3D12_ROOT_DESCRIPTOR_TABLE1](https://devdocs.xbox.com/pt-BR/reference/graphics/d3d12/structs/d3d12_root_descriptor_table1_public.md)
- [D3D12_DESCRIPTOR_RANGE_FLAGS](https://devdocs.xbox.com/pt-BR/reference/graphics/d3d12/enums/d3d12_descriptor_range_flags_public.md)
- [D3D12_ROOT_DESCRIPTOR_TABLE](https://devdocs.xbox.com/pt-BR/reference/graphics/d3d12/structs/d3d12_root_descriptor_table_public.md)
- [D3D12_FEATURE_DATA_ARCHITECTURE1](https://devdocs.xbox.com/pt-BR/reference/graphics/d3d12/structs/d3d12_feature_data_architecture1_public.md)
- [D3D12_ROOT_DESCRIPTOR](https://devdocs.xbox.com/pt-BR/reference/graphics/d3d12/structs/d3d12_root_descriptor_public.md)