D3D12_HEAP_PROPERTIES 结构 (d3d12.h)

描述堆属性。

语法

typedef struct D3D12_HEAP_PROPERTIES {
  D3D12_HEAP_TYPE         Type;
  D3D12_CPU_PAGE_PROPERTY CPUPageProperty;
  D3D12_MEMORY_POOL       MemoryPoolPreference;
  UINT                    CreationNodeMask;
  UINT                    VisibleNodeMask;
} D3D12_HEAP_PROPERTIES;

成员

Type

一个D3D12_HEAP_TYPE类型的值，该值指定堆的类型。

CPUPageProperty

一个D3D12_CPU_PAGE_PROPERTY类型的值，该值指定堆的 CPU 页属性。

MemoryPoolPreference

一个D3D12_MEMORY_POOL类型的值，该值指定堆的内存池。

CreationNodeMask

对于多适配器操作，这指示应在其中创建资源的节点。

必须设置此 UINT 的一个位。 请参阅 多适配器系统。

传递 0 等效于传递 1，以便简化单 GPU 适配器的使用。

VisibleNodeMask

对于多适配器操作，这表示资源可见的节点集。

VisibleNodeMask 的位集必须与 CreationNodeMask 中设置的位集相同。 VisibleNodeMask还可以 为跨节点资源设置其他位，但这样做可能会降低资源访问的性能，因此应仅在需要时执行此操作。

传递 0 等效于传递 1，以便简化单 GPU 适配器的使用。

注解

此结构由以下各项使用：

• D3D12_HEAP_DESC 结构
• ID3D12Resource：：GetHeapProperties
• ID3D12Device：：GetCustomHeapProperties
• ID3D12Device：：CreateCommittedResource

结构成员值的有效组合：

• D3D12_HEAP_TYPE类型时_CUSTOM不得..._UNKNOWN CPUPageProperty 和 MemoryPoolPreference。
• 如果未D3D12_HEAP_TYPE_CUSTOM Type ，则必须..._UNKNOWN CPUPageProperty 和 MemoryPoolPreference 。
• 使用 D3D12_HEAP_TYPE_CUSTOM 和 D3D12_MEMORY_POOL 时_L1，在 NUMA 适配器上，必须D3D12_CPU_PAGE_PROPERTYCPUPageProperty_NOT_AVAILABLE。 若要将 NUMA 与 UMA 适配器区分开来，请参阅 D3D12_FEATURE_ARCHITECTURE和 D3D12_FEATURE_DATA_ARCHITECTURE。

要求

要求	值
Header	d3d12.h

另请参阅

CD3DX12_HEAP_PROPERTIES

核心结构

描述符堆