Partager via

Structure D3D12_HEAP_PROPERTIES (d3d12.h)

  • Article

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 de type D3D12_CPU_PAGE_PROPERTY qui spécifie les propriétés de page processeur pour le tas.

MemoryPoolPreference

Valeur de type D3D12_MEMORY_POOL 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.

Exactement un bit de cette UINT doit être défini. Consultez Systèmes multi-adaptateurs.

Passer zéro équivaut à en passer un, afin de simplifier l’utilisation des cartes à 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 que celui 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.

Passer zéro équivaut à en passer un, afin de simplifier l’utilisation des cartes à gpu unique.

Remarques

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

Combinaisons valides de valeurs de membre de struct :
  • Lorsque Type est D3D12_HEAP_TYPE_CUSTOM, CPUPageProperty et MemoryPoolPreference ne doivent pas être ..._UNKNOWN.
  • Lorsque 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.

Configuration requise

Condition requise Valeur
En-tête d3d12.h

Voir aussi

CD3DX12_HEAP_PROPERTIES

Structures de base

Segments de mémoire de descripteur