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

> 提供有关适配器是否支持从现有系统内存创建堆的详细信息。

提供有关适配器是否支持从现有系统内存创建堆的详细信息。此类堆并非用于一般用途,但对诊断目的非常有用,因为即使在适配器出现故障或经历设备移除事件之后,它们也可以保证持续存在。对于 [ID3D12Device::CreateHeap](https://docs.xbox.com/zh-CN/reference/graphics/d3d12/interfaces/id3d12device/methods/id3d12device_createheap_public.md) 或 [ID3D12Device::CreateCommittedResource](https://docs.xbox.com/zh-CN/reference/graphics/d3d12/interfaces/id3d12device/methods/id3d12device_createcommittedresource_public.md) 返回的堆,即使堆驻留在系统内存中,也不能保证持久性。

## 语法

```cpp theme={null}
typedef struct D3D12_FEATURE_DATA_EXISTING_HEAPS
{
    BOOL Supported;
} D3D12_FEATURE_DATA_EXISTING_HEAPS
```

### 成员

*Supported*\
类型:BOOL

如果适配器可以从现有系统内存创建堆,则为 **TRUE**。否则为 **FALSE**。

## 备注

出于各种性能和兼容性原因,应用程序除了用于诊断目的外,不应使用此功能。特别是,使用此功能创建的堆仅支持具有跨适配器属性的系统内存堆,这排除了典型应用程序场景可能利用的许多优化机会。

## 要求

**头文件:** 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)

[D3D12\_FEATURE](https://docs.xbox.com/zh-CN/reference/graphics/d3d12/enums/d3d12_feature_public.md)

[ID3D12Device::CreateCommittedResource](https://docs.xbox.com/zh-CN/reference/graphics/d3d12/interfaces/id3d12device/methods/id3d12device_createcommittedresource_public.md)

[ID3D12Device::CreateHeap](https://docs.xbox.com/zh-CN/reference/graphics/d3d12/interfaces/id3d12device/methods/id3d12device_createheap_public.md)


## Related topics

- [D3D12_FEATURE](https://docs.xbox.com/zh-CN/reference/graphics/d3d12/enums/d3d12_feature_public.md)
- [D3D12_FEATURE_DATA_SERIALIZATION](https://docs.xbox.com/zh-CN/reference/graphics/d3d12/structs/d3d12_feature_data_serialization_public.md)
- [D3D12_RESOURCE_HEAP_TIER](https://docs.xbox.com/zh-CN/reference/graphics/d3d12/enums/d3d12_resource_heap_tier_public.md)
- [D3D12_HEAP_TYPE](https://docs.xbox.com/zh-CN/reference/graphics/d3d12/enums/d3d12_heap_type_public.md)
- [D3D12_FEATURE_DATA_D3D12_OPTIONS](https://docs.xbox.com/zh-CN/reference/graphics/d3d12/structs/d3d12_feature_data_d3d12_options_public.md)