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 的一個位。 請參閱 多配接器系統。

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

VisibleNodeMask

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

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

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

言論

此結構由下列專案使用：

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

結構成員值的有效組合：

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

要求

要求	價值
標頭	d3d12.h

另請參閱

CD3DX12_HEAP_PROPERTIES

核心結構

描述元堆積