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

指定堆積之 CPU 頁面屬性 的D3D12_CPU_PAGE_PROPERTY型別值。

MemoryPoolPreference

指定堆積記憶體集區的 D3D12_MEMORY_POOL型別值。

CreationNodeMask

針對多配接器作業，這表示應該建立資源的節點。

必須設定此 UINT 的一個位。 請參閱 多配接器系統。

傳遞零相當於傳遞一個，以簡化單一 GPU 適配卡的使用方式。

VisibleNodeMask

針對多配接器作業，這表示資源可見的節點集。

VisibleNodeMask 必須有在 CreationNodeMask 中設定的相同位集。 VisibleNodeMask也可以 針對跨節點資源設定額外的位，但這麼做可能會降低資源存取的效能，因此您只應該視需要這麼做。

傳遞零相當於傳遞一個，以簡化單一 GPU 適配卡的使用方式。

備註

此結構由下列專案使用：

• D3D12_HEAP_DESC 結構
• ID3D12Resource：：GetHeapProperties
• ID3D12Device：：GetCustomHeapProperties
• ID3D12Device：：CreateCommittedResource

結構成員值的有效組合：

• 當 TypeD3D12_HEAP_TYPE_CUSTOM時， CPUPageProperty 和 MemoryPoolPreference 不得..._UNKNOWN。
• 當 Type 未D3D12_HEAP_TYPE_CUSTOM時， CPUPageProperty 和 MemoryPoolPreference 必須..._UNKNOWN。
• 在 NUMA 配接器上使用 D3D12_HEAP_TYPE_CUSTOM 和 D3D12_MEMORY_POOL_L1時， CPUPageProperty 必須 D3D12_CPU_PAGE_PROPERTY_NOT_AVAILABLE。 若要區分 NUMA 與 UMA 配接器，請參閱 D3D12_FEATURE_ARCHITECTURE和 D3D12_FEATURE_DATA_ARCHITECTURE。

規格需求

需求	值
標頭	d3d12.h

另請參閱

CD3DX12_HEAP_PROPERTIES

核心結構

描述項堆積