Estrutura D3D12_HEAP_PROPERTIES (d3d12.h)

Descreve as propriedades do heap.

Sintaxe

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;

Membros

Type

Um valor do tipo D3D12_HEAP_TYPE que especifica o tipo de heap.

CPUPageProperty

Um valor do tipo D3D12_CPU_PAGE_PROPERTY que especifica as propriedades da página da CPU para o heap.

MemoryPoolPreference

Um valor do tipo D3D12_MEMORY_POOL que especifica o pool de memória para o heap.

CreationNodeMask

Para a operação de vários adaptadores, isso indica o nó em que o recurso deve ser criado.

Exatamente um bit desse UINT deve ser definido. Consulte Sistemas de vários adaptadores.

Passar zero é equivalente à passagem de um, a fim de simplificar o uso de adaptadores de GPU única.

VisibleNodeMask

Para a operação de vários adaptadores, isso indica o conjunto de nós em que o recurso está visível.

VisibleNodeMask deve ter o mesmo conjunto de bits definido em CreationNodeMask. VisibleNodeMasktambém pode ter bits adicionais definidos para recursos entre nós, mas isso pode reduzir potencialmente o desempenho para acessos de recursos, portanto, você deve fazê-lo somente quando necessário.

Passar zero é equivalente à passagem de um, a fim de simplificar o uso de adaptadores de GPU única.

Comentários

Essa estrutura é usada pelo seguinte:

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

Combinações válidas de valores de membro struct:

• Quando Type é D3D12_HEAP_TYPE_CUSTOM, CPUPageProperty e MemoryPoolPreference não devem ser ..._UNKNOWN.
• Quando Type não está D3D12_HEAP_TYPE_CUSTOM, CPUPageProperty e MemoryPoolPreference devem ser ..._UNKNOWN.
• Ao usar D3D12_HEAP_TYPE_CUSTOM e D3D12_MEMORY_POOL_L1, em adaptadores NUMA, CPUPageProperty deve ser D3D12_CPU_PAGE_PROPERTY_NOT_AVAILABLE. Para diferenciar NUMA de adaptadores UMA, consulte D3D12_FEATURE_ARCHITECTURE e D3D12_FEATURE_DATA_ARCHITECTURE.

Requisitos

Requisito	Valor
Cabeçalho	d3d12.h

Confira também

CD3DX12_HEAP_PROPERTIES

Estruturas do núcleo

Heaps de descritor