Metodo ID3D12Device::CopyDescriptorsSimple (d3d12.h)

Articolo
08/23/2023

Copia i descrittori da un'origine a una destinazione.

Sintassi

void CopyDescriptorsSimple(
  [in] UINT                        NumDescriptors,
  [in] D3D12_CPU_DESCRIPTOR_HANDLE DestDescriptorRangeStart,
  [in] D3D12_CPU_DESCRIPTOR_HANDLE SrcDescriptorRangeStart,
  [in] D3D12_DESCRIPTOR_HEAP_TYPE  DescriptorHeapsType
);

Parametri

[in] NumDescriptors

Tipo: UINT

Numero di descrittori da copiare.

[in] DestDescriptorRangeStart

Tipo: D3D12_CPU_DESCRIPTOR_HANDLE

D3D12_CPU_DESCRIPTOR_HANDLE che descrive i descrittori di destinazione in cui iniziare a eseguire la copia.

I descrittori di destinazione e di origine devono trovarsi in heaps dello stesso D3D12_DESCRIPTOR_HEAP_TYPE.

[in] SrcDescriptorRangeStart

Tipo: D3D12_CPU_DESCRIPTOR_HANDLE

D3D12_CPU_DESCRIPTOR_HANDLE che descrive i descrittori di origine da cui iniziare a copiare.

Importante

Il parametro SrcDescriptorRangeStart deve trovarsi in un heap del descrittore non visibile a shader. Questo è dovuto al fatto che gli heaps visibili dello shader possono essere creati in memoria WRITE_COMBINE o memoria locale della GPU, che è proibitivamente lenta da leggere. Se l'applicazione gestisce gli heaps descrittori tramite la copia dei descrittori necessari per un determinato heaps pass o frame dal descrittore locale "storage" all'heap associato alla GPU, usare gli heaps shader-opaco per l'heaps di archiviazione e copiare nell'heap visibile della GPU in base alle esigenze.

[in] DescriptorHeapsType

Tipo: D3D12_DESCRIPTOR_HEAP_TYPE

Valore D3D12_DESCRIPTOR_HEAP_TYPE tipizzato che specifica il tipo di heap descrittore con cui copiare. Questa operazione è necessaria come tipi di descrittore diversi possono avere dimensioni diverse.

Sia il descrittore di origine che quello di destinazione devono avere lo stesso tipo, altrimenti il livello di debug genererà un errore.

Valore restituito

nessuno

Osservazioni

Se applicabile, preferire questo metodo a ID3D12Device::CopyDescriptors. Può avere una migliore frequenza di mancata frequenza della cache della CPU a causa della natura lineare della copia.

Requisiti


Piattaforma di destinazione	Windows
Intestazione	d3d12.h
Libreria	D3D12.lib
DLL	D3D12.dll

Vedi anche

Copia di descrittori

ID3D12Device

Condividi tramite