Pular para o conteúdo principal
Copia descritores de uma origem para um destino.

Sintaxe

Parâmetros

NumDestDescriptorRanges [in]
Tipo: UINT
O número de intervalos de descritores de destino para os quais copiar. pDestDescriptorRangeStarts [in]
Tipo: const D3D12_CPU_DESCRIPTOR_HANDLE *
Uma matriz de objetos D3D12_CPU_DESCRIPTOR_HANDLE para os quais copiar. Todos os descritores de destino e de origem devem estar em heaps do mesmo D3D12_DESCRIPTOR_HEAP_TYPE. pDestDescriptorRangeSizes [in, optional]
Tipo: const UINT *
Uma matriz de tamanhos de intervalos de descritores de destino para os quais copiar. NumSrcDescriptorRanges [in]
Tipo: UINT
O número de intervalos de descritores de origem dos quais copiar. pSrcDescriptorRangeStarts [in]
Tipo: const D3D12_CPU_DESCRIPTOR_HANDLE *
Uma matriz de objetos D3D12_CPU_DESCRIPTOR_HANDLE dos quais copiar.
Todos os elementos no parâmetro pSrcDescriptorRangeStarts devem estar em um heap de descritores não visível para shaders. Isso ocorre porque os heaps de descritores visíveis para shaders podem ser criados em memória WRITE_COMBINE ou na memória local da GPU, cuja leitura é proibitivamente lenta. Se o seu aplicativo gerencia os heaps de descritores copiando os descritores necessários para uma determinada passagem ou quadro de heaps de descritores de “armazenamento” locais para o heap de descritores vinculado à GPU, use heaps opacos para shaders como heaps de armazenamento e copie para o heap visível para a GPU conforme necessário.
pSrcDescriptorRangeSizes [in, optional]
Tipo: const UINT *
Uma matriz de tamanhos de intervalos de descritores de origem dos quais copiar. DescriptorHeapsType [in]
Tipo: D3D12_DESCRIPTOR_HEAP_TYPE
O valor do tipo D3D12_DESCRIPTOR_HEAP_TYPE que especifica o tipo de heap de descritores usado na cópia. Isso é necessário porque diferentes tipos de descritores podem ter tamanhos diferentes. Os heaps de descritores de origem e de destino devem ter o mesmo tipo; caso contrário, a camada de depuração emitirá um erro.

Valor retornado

Tipo: void Nenhum.

Comentários

Quando aplicável, prefira ID3D12Device::CopyDescriptorsSimple a este método. Ele pode ter uma taxa de falhas de cache da CPU melhor devido à natureza linear da cópia.

Requisitos

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

Confira também

Copiando descritores ID3D12Device
Última modificação em 6 de outubro de 2026