D3D12_HEAP_PROPERTIES Struktur (d3d12.h)

Beschreibt heap-Eigenschaften.

Syntax

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;

Angehörige

Type

Ein D3D12_HEAP_TYPE-typed-Wert, der den Typ des Heaps angibt.

CPUPageProperty

Ein D3D12_CPU_PAGE_PROPERTY-typed-Wert, der die CPU-Seiteneigenschaften für den Heap angibt.

MemoryPoolPreference

Ein D3D12_MEMORY_POOL-typed-Wert, der den Speicherpool für den Heap angibt.

CreationNodeMask

Für den Vorgang mit mehreren Adaptern gibt dies den Knoten an, in dem die Ressource erstellt werden soll.

Genau ein Bit dieses UINT muss festgelegt werden. Siehe Multiadaptersysteme.

Das Übergeben von Null entspricht dem Übergeben eines, um die Verwendung von Einzel-GPU-Adaptern zu vereinfachen.

VisibleNodeMask

Für den Vorgang mit mehreren Adaptern gibt dies den Satz von Knoten an, in denen die Ressource sichtbar ist.

VisibleNodeMask- muss den gleichen Bitsatz aufweisen, der in CreationNodeMaskfestgelegt ist. VisibleNodeMask- kann auch zusätzliche Bits für knotenübergreifende Ressourcen festgelegt haben, dies kann jedoch die Leistung für Ressourcenzugriffe potenziell verringern, sodass Sie dies nur bei Bedarf tun sollten.

Das Übergeben von Null entspricht dem Übergeben eines, um die Verwendung von Einzel-GPU-Adaptern zu vereinfachen.

Bemerkungen

Diese Struktur wird von folgenden Komponenten verwendet:

• D3D12_HEAP_DESC Struktur
• ID3D12Resource::GetHeapProperties
• ID3D12Device::GetCustomHeapProperties
• ID3D12Device::CreateCommittedResource-

Gültige Kombinationen von Strukturmememmwerten:

• Wenn TypeD3D12_HEAP_TYPE_CUSTOM ist, dürfen CPUPageProperty und MemoryPoolPreference- nicht ..._UNKNOWN werden.
• Wenn Type nicht D3D12_HEAP_TYPE_CUSTOM ist, müssen CPUPageProperty und MemoryPoolPreference- ..._UNKNOWN werden.
• Bei Verwendung von D3D12_HEAP_TYPE_CUSTOM und D3D12_MEMORY_POOL_L1 müssen auf NUMA-Adaptern CPUPageProperty-D3D12_CPU_PAGE_PROPERTY_NOT_AVAILABLE werden. Informationen zum Unterscheiden von NUMA-Adaptern finden Sie unter D3D12_FEATURE_ARCHITECTURE und D3D12_FEATURE_DATA_ARCHITECTURE.

Anforderungen

Anforderung	Wert
Header-	d3d12.h

Siehe auch

CD3DX12_HEAP_PROPERTIES

Kernstrukturen

Heaps