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

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

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

## 语法

```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](/reference/graphics/d3d12/enums/d3d12_feature_public)

[ID3D12Device::CreateCommittedResource](/reference/graphics/d3d12/interfaces/id3d12device/methods/id3d12device_createcommittedresource_public)

[ID3D12Device::CreateHeap](/reference/graphics/d3d12/interfaces/id3d12device/methods/id3d12device_createheap_public)