> ## 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](/zh-TW/reference/graphics/d3d12/interfaces/id3d12device/methods/id3d12device_createheap_public) 或 [ID3D12Device::CreateCommittedResource](/zh-TW/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](/zh-TW/reference/graphics/d3d12/enums/d3d12_feature_public)

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

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


## Related topics

- [D3D12_FEATURE](/zh-TW/reference/graphics/d3d12/enums/d3d12_feature_public.md)
- [D3D12_FEATURE_DATA_SERIALIZATION](/zh-TW/reference/graphics/d3d12/structs/d3d12_feature_data_serialization_public.md)
- [D3D12_RESOURCE_HEAP_TIER](/zh-TW/reference/graphics/d3d12/enums/d3d12_resource_heap_tier_public.md)
- [D3D12_FEATURE_DATA_D3D12_OPTIONS](/zh-TW/reference/graphics/d3d12/structs/d3d12_feature_data_d3d12_options_public.md)
- [D3D12_HEAP_TYPE](/zh-TW/reference/graphics/d3d12/enums/d3d12_heap_type_public.md)