D3D12_FEATURE_DATA_EXISTING_HEAPS structure (d3d12.h)

Provides detail about whether the adapter supports creating heaps from existing system memory. Such heaps are not intended for general use, but are exceptionally useful for diagnostic purposes, because they are guaranteed to persist even after the adapter faults or experiences a device-removal event. Persistence is not guaranteed for heaps returned by ID3D12Device::CreateHeap or ID3D12Device::CreateCommittedResource, even when the heap resides in system memory.

Syntax

typedef struct D3D12_FEATURE_DATA_EXISTING_HEAPS {
  BOOL Supported;
} D3D12_FEATURE_DATA_EXISTING_HEAPS;

Members

Supported

TRUE if the adapter can create a heap from existing system memory. Otherwise, FALSE.

Remarks

For a variety of performance and compatibility reasons, applications should not make use of this feature except for diagnostic purposes. In particular, heaps created using this feature only support system-memory heaps with cross-adapter properties, which precludes many optimization opportunities that typical application scenarios could otherwise take advantage of.

Requirements

Requirement Value
Header d3d12.h

See also

Core Structures

D3D12_FEATURE

ID3D12Device::CreateCommittedResource

ID3D12Device::CreateHeap