> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# D3D12_DRED_ENABLEMENT

> 定义指定渲染/计算 GPU 操作的常量。(D3D12_DRED_ENABLEMENT)

定义常量（由 [ID3D12DeviceRemovedExtendedDataSettings 接口](https://docs.xbox.com/zh-CN/reference/graphics/d3d12/interfaces/id3d12deviceremovedextendeddatasettings/id3d12deviceremovedextendeddatasettings_public.md)使用），用于指定如何启用单个"设备已移除的扩展数据"(DRED) 功能。自 DRED 版本 1.1 起，所有设置的默认值均为 **D3D12\_DRED\_ENABLEMENT\_SYSTEM\_CONTROLLED**。

## 语法

```cpp theme={null}
typedef enum D3D12_DRED_ENABLEMENT
{
    D3D12_DRED_ENABLEMENT_SYSTEM_CONTROLLED (0) = 0,
    D3D12_DRED_ENABLEMENT_FORCED_OFF (1) = 0,
    D3D12_DRED_ENABLEMENT_FORCED_ON (2) = 0
} D3D12_DRED_ENABLEMENT
```

## 常量

| 常量 | 说明 |
| - | - |
| D3D12\_DRED\_ENABLEMENT\_SYSTEM\_CONTROLLED (0) | 指定仅当系统自动开启 DRED 时（例如，用户通过 FeedbackHub 重现问题时）启用 DRED 功能。 |
| D3D12\_DRED\_ENABLEMENT\_FORCED\_OFF (1) | 指定应强制禁用 DRED 功能，无论系统状态如何。 |
| D3D12\_DRED\_ENABLEMENT\_FORCED\_ON (2) | 指定应强制启用 DRED 功能，无论系统状态如何。 |

## 注解

## 要求

**头文件：** 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)
* [使用 DRED 诊断 GPU 故障](https://learn.microsoft.com/en-us/windows/desktop/direct3d12/use-dred)


## Related topics

- [SetPageFaultEnablement](https://docs.xbox.com/zh-CN/reference/graphics/d3d12/interfaces/id3d12deviceremovedextendeddatasettings/methods/id3d12deviceremovedextendeddatasettings_setpagefaultenablement_public.md)
- [SetWatsonDumpEnablement](https://docs.xbox.com/zh-CN/reference/graphics/d3d12/interfaces/id3d12deviceremovedextendeddatasettings/methods/id3d12deviceremovedextendeddatasettings_setwatsondumpenablement_public.md)
- [D3D12_DRED_ALLOCATION_TYPE](https://docs.xbox.com/zh-CN/reference/graphics/d3d12/enums/d3d12_dred_allocation_type_public.md)
- [D3D12_DRED_VERSION](https://docs.xbox.com/zh-CN/reference/graphics/d3d12/enums/d3d12_dred_version_public.md)
- [D3D12_DRED_FLAGS](https://docs.xbox.com/zh-CN/reference/graphics/d3d12/enums/d3d12_dred_flags_public.md)