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;

Members

Type

Valore D3D12_HEAP_TYPE tipizzato che specifica il tipo di heap.

CPUPageProperty

Valore D3D12_CPU_PAGE_PROPERTY tipizzato che specifica le proprietà della pagina DELLA CPU per l'heap.

MemoryPoolPreference

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

CreationNodeMask

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

È necessario impostare esattamente un bit di questo UINT. Vedere Sistemi multi-adapter.

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

VisibleNodeMask

Per l'operazione multi-adapter, questo 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 può 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.

Commenti

Questa struttura viene usata dai seguenti elementi:

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

Combinazioni valide di valori membro struct:

• Quando Type è D3D12_HEAP_TYPE_CUSTOM, CPUPageProperty e MemoryPoolPreference non devono 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.

Requisiti

Requisito	Valore
Intestazione	d3d12.h

Vedi anche

CD3DX12_HEAP_PROPERTIES

Strutture principali

Heaps descrittore