Pular para o conteúdo principal
Altera os heaps de descritores atualmente associados a uma lista de comandos.

Sintaxe

Parâmetros

NumDescriptorHeaps
Tipo: UINT
Número de heaps de descritores a serem associados. ppDescriptorHeaps
Tipo: [in] ID3D12DescriptorHeap*
Um ponteiro para uma matriz de objetos ID3D12DescriptorHeap para os heaps a serem definidos na lista de comandos. Você só pode associar heaps de descritores do tipo D3D12_DESCRIPTOR_HEAP_TYPE_CBV_SRV_UAV e D3D12_DESCRIPTOR_HEAP_TYPE_SAMPLER. Somente um heap de descritores de cada tipo pode ser definido por vez, o que significa que no máximo 2 heaps (um sampler, um CBV/SRV/UAV) podem ser definidos ao mesmo tempo.

Valor retornado

Tipo: void Nenhum.

Comentários

SetDescriptorHeaps pode ser chamado em um pacote, mas os heaps de descritores do pacote devem corresponder ao heap de descritores da lista de comandos chamadora. Para obter mais informações sobre restrições de pacotes, consulte Criando e gravando listas de comandos e pacotes. Todos os heaps definidos anteriormente são removidos pela chamada. No máximo um heap de cada tipo visível ao sombreador pode ser definido na chamada. A alteração dos heaps de descritores pode causar uma liberação do pipeline em alguns hardwares. Por isso, é recomendável usar um único heap visível ao sombreador de cada tipo e defini-lo uma vez por quadro, em vez de alterar regularmente os heaps de descritores associados. Em vez disso, use ID3D12Device::CopyDescriptors e ID3D12Device::CopyDescriptorsSimple para copiar os descritores necessários dos heaps opacos ao sombreador para o único heap visível ao sombreador, conforme necessário durante a renderização.

Exemplos

O exemplo D3D12Bundles usa ID3D12GraphicsCommandList::SetDescriptorHeaps da seguinte maneira:
Consulte Código de exemplo na referência do D3D12.

Requisitos

Cabeçalho: d3d12_xs.h ou d3d12_x.h
Biblioteca: d3d12_xs.lib ou d3d12_x.lib
Plataformas com suporte: consoles XBOX Series e família XBOX One

Confira também

Heaps de descritores ID3D12GraphicsCommandList
Última modificação em 6 de outubro de 2026