structure D3D12_HEAP_PROPERTIES (d3d12.h)

Article
07/16/2024

Décrit les propriétés du tas.

Syntaxe

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;

Membres

Type

Valeur D3D12_HEAP_TYPE-typée qui spécifie le type de tas.

CPUPageProperty

Valeur D3D12_CPU_PAGE_PROPERTY-typée qui spécifie les propriétés de la page UC pour le tas.

MemoryPoolPreference

Valeur D3D12_MEMORY_POOL-typée qui spécifie le pool de mémoires pour le tas.

CreationNodeMask

Pour l’opération multi-adaptateur, cela indique le nœud où la ressource doit être créée.

Un bit exactement de cet UINT doit être défini. Consultez systèmes multi-adaptateurs.

Le passage de zéro équivaut à en passer un, afin de simplifier l’utilisation des adaptateurs à gpu unique.

VisibleNodeMask

Pour l’opération multi-adaptateur, cela indique l’ensemble de nœuds où la ressource est visible.

VisibleNodeMask doit avoir le même jeu de bits défini dans CreationNodeMask. VisibleNodeMask peut également avoir des bits supplémentaires définis pour les ressources entre nœuds, mais cela peut potentiellement réduire les performances des accès aux ressources. Vous devez donc le faire uniquement si nécessaire.

Le passage de zéro équivaut à en passer un, afin de simplifier l’utilisation des adaptateurs à gpu unique.

Remarques

Cette structure est utilisée par les éléments suivants :

Combinaisons valides de valeurs membres de struct :

Lorsque type est D3D12_HEAP_TYPE_CUSTOM, CPUPageProperty et MemoryPoolPreference ne doivent pas être ..._UNKNOWN.
Quand type n’est pas D3D12_HEAP_TYPE_CUSTOM, cpuPageProperty et MemoryPoolPreference doivent être ..._UNKNOWN.
Lorsque vous utilisez D3D12_HEAP_TYPE_CUSTOM et D3D12_MEMORY_POOL_L1, sur les adaptateurs NUMA, cpuPageProperty doit être D3D12_CPU_PAGE_PROPERTY_NOT_AVAILABLE. Pour différencier NUMA des adaptateurs UMA, consultez D3D12_FEATURE_ARCHITECTURE et D3D12_FEATURE_DATA_ARCHITECTURE.

Exigences

Exigence	Valeur
d’en-tête	d3d12.h

Voir aussi

CD3DX12_HEAP_PROPERTIES

structures principales

tas de descripteurs

Partager via