estrutura D3D12_HEAP_PROPERTIES (d3d12.h)

Artigo
07/16/2024

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 D3D12_HEAP_TYPEdigitado que especifica o tipo de heap.

CPUPageProperty

Um valor D3D12_CPU_PAGE_PROPERTYdigitado que especifica as propriedades da página da CPU para o heap.

MemoryPoolPreference

Um valor D3D12_MEMORY_POOLdigitado que especifica o pool de memória do 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 multi-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. VisibleNodeMask também podem ter bits adicionais definidos para recursos entre nós, mas isso pode reduzir potencialmente o desempenho para acessos a 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.

Observações

Essa estrutura é usada pelo seguinte:

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

Quando de Tipo é D3D12_HEAP_TYPE_CUSTOM, CPUPageProperty e MemoryPoolPreference não devem ser ..._UNKNOWN.
Quando tipo não é 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 devem 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

Consulte também

CD3DX12_HEAP_PROPERTIES

estruturas do Core

heaps de descritor

Compartilhar via