struttura D3D12_HEAP_PROPERTIES (d3d12.h)

Descrive le proprietà dell'heap.

Sintassi

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;

Membri

Type

Valore D3D12_HEAP_TYPEtipizzato che specifica il tipo di heap.

CPUPageProperty

Valore D3D12_CPU_PAGE_PROPERTY-typed che specifica le proprietà cpu-page per l'heap.

MemoryPoolPreference

Valore D3D12_MEMORY_POOLtipizzato che specifica il pool di memoria per l'heap.

CreationNodeMask

Per l'operazione multi-adapter, indica il nodo in cui deve essere creata la risorsa.

È necessario impostare esattamente un bit di questo UINT. Vedere sistemi a più schede.

Il passaggio di zero equivale al passaggio di uno, per semplificare l'utilizzo di schede GPU singole.

VisibleNodeMask

Per l'operazione multi-adapter, indica il set di nodi in cui la risorsa è visibile.

VisibleNodeMask deve avere lo stesso set di bit impostato in CreationNodeMask. VisibleNodeMask può anche avere bit aggiuntivi impostati per le risorse tra nodi, ma in questo modo è possibile ridurre potenzialmente le prestazioni per gli accessi alle risorse, quindi è consigliabile farlo solo quando necessario.

Il passaggio di zero equivale al passaggio di uno, per semplificare l'utilizzo di schede GPU singole.

Osservazioni

Questa struttura viene utilizzata dai seguenti elementi:

• struttura D3D12_HEAP_DESC
• ID3D12Resource::GetHeapProperties
• ID3D12Device::GetCustomHeapProperties
• ID3D12Device::CreateCommittedResource

• Quando Tipo è D3D12_HEAP_TYPE_CUSTOM, CPUPageProperty e MemoryPoolPreference non deve essere ..._UNKNOWN.
• Quando Type non è D3D12_HEAP_TYPE_CUSTOM, CPUPageProperty e MemoryPoolPreference devono essere ..._UNKNOWN.
• Quando si usano D3D12_HEAP_TYPE_CUSTOM e D3D12_MEMORY_POOL_L1, nelle schede NUMA CPUPageProperty deve essere D3D12_CPU_PAGE_PROPERTY_NOT_AVAILABLE. Per distinguere NUMA dalle schede UMA, vedere D3D12_FEATURE_ARCHITECTURE e D3D12_FEATURE_DATA_ARCHITECTURE.

Fabbisogno

Vedere anche

CD3DX12_HEAP_PROPERTIES

strutture principali

heap del descrittore