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

> 在根簽章 1.1 描述中，指定描述元及其參考之資料的變動性，這可啟用某些驅動程式最佳化。

在根簽章 1.1 描述中，指定描述元及其參考之資料的變動性，這可啟用某些驅動程式最佳化。

## 語法

```cpp theme={null}
typedef enum D3D12_DESCRIPTOR_RANGE_FLAGS
{
    D3D12_DESCRIPTOR_RANGE_FLAG_NONE = 0,
    D3D12_DESCRIPTOR_RANGE_FLAG_DESCRIPTORS_VOLATILE = 1,
    D3D12_DESCRIPTOR_RANGE_FLAG_DATA_VOLATILE = 2,
    D3D12_DESCRIPTOR_RANGE_FLAG_DATA_STATIC_WHILE_SET_AT_EXECUTE = 4,
    D3D12_DESCRIPTOR_RANGE_FLAG_DATA_STATIC = 8,
    D3D12_DESCRIPTOR_RANGE_FLAG_DESCRIPTORS_STATIC_KEEPING_BUFFER_BOUNDS_CHECKS = 65536
} D3D12_DESCRIPTOR_RANGE_FLAGS
```

## 常數

| 常數 | 描述 |
| - | - |
| D3D12\_DESCRIPTOR\_RANGE\_FLAG\_NONE | 預設行為。描述元是靜態的，並對資料採用預設假設 (SRV/CBV：DATA\_STATIC\_WHILE\_SET\_AT\_EXECUTE，UAV：DATA\_VOLATILE)。 |
| D3D12\_DESCRIPTOR\_RANGE\_FLAG\_DESCRIPTORS\_VOLATILE | 如果這是唯一設定的旗標，則描述元是可變動的，並對資料採用預設假設 (SRV/CBV：DATA\_STATIC\_WHILE\_SET\_AT\_EXECUTE，UAV：DATA\_VOLATILE)。如果此旗標與 DATA\_VOLATILE 結合，則描述元和資料都是可變動的，這相當於根簽章版本 1.0。如果此旗標與 DATA\_STATIC\_WHILE\_SET\_AT\_EXECUTE 結合，則描述元是可變動的。這仍然不允許它們在命令清單執行期間變更，因此可以合法地結合額外宣告，表示資料在執行期間透過根描述元表格設定時是靜態的；基礎描述元實際上保持靜態的時間，比承諾資料保持靜態的時間更長。 |
| D3D12\_DESCRIPTOR\_RANGE\_FLAG\_DATA\_VOLATILE | 描述元是靜態的，而資料是可變動的。 |
| D3D12\_DESCRIPTOR\_RANGE\_FLAG\_DATA\_STATIC\_WHILE\_SET\_AT\_EXECUTE | 描述元是靜態的，且資料在執行時設定期間是靜態的。 |
| D3D12\_DESCRIPTOR\_RANGE\_FLAG\_DATA\_STATIC | 描述元和資料都是靜態的。這可將驅動程式最佳化的可能性最大化。 |
| D3D12\_DESCRIPTOR\_RANGE\_FLAG\_DESCRIPTORS\_STATIC\_KEEPING\_BUFFER\_BOUNDS\_CHECKS | 提供與靜態描述元相同的好處 (請參閱 **D3D12\_DESCRIPTOR\_RANGE\_FLAG\_NONE**)，但不允許驅動程式將緩衝區提升為根描述元作為最佳化，因為緩衝區必須維持界限檢查，而根描述元沒有界限檢查。 |

## 備註

此列舉由 [D3D12\_DESCRIPTOR\_RANGE1](/zh-TW/reference/graphics/d3d12/structs/d3d12_descriptor_range1_public) 結構使用。

若只要指定描述元所參考之資料的變動性，請參閱 [D3D12\_ROOT\_DESCRIPTOR\_FLAGS](/zh-TW/reference/graphics/d3d12/enums/d3d12_root_descriptor_flags_public)。

## 需求

**標頭：** 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-enumerations)

[根簽章版本 1.1](https://learn.microsoft.com/en-us/windows/desktop/direct3d12/root-signature-version-1-1)


## Related topics

- [D3D12_ROOT_DESCRIPTOR_FLAGS](/zh-TW/reference/graphics/d3d12/enums/d3d12_root_descriptor_flags_public.md)
- [D3D12_DESCRIPTOR_RANGE1](/zh-TW/reference/graphics/d3d12/structs/d3d12_descriptor_range1_public.md)
- [GetRootSignatureDescAtVersion](/zh-TW/reference/graphics/d3d12/interfaces/id3d12versionedrootsignaturedeserializer/methods/id3d12versionedrootsignaturedeserializer_getrootsignaturedescatversion_public.md)
- [D3D12_DESCRIPTOR_RANGE](/zh-TW/reference/graphics/d3d12/structs/d3d12_descriptor_range_public.md)
- [D3D12_DESCRIPTOR_RANGE_TYPE](/zh-TW/reference/graphics/d3d12/enums/d3d12_descriptor_range_type_public.md)