Método ID3D12Device::CopyDescriptorsSimple (d3d12.h)

  • Artigo

Copia descritores de uma origem para um destino.

Sintaxe

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

Parâmetros

[in] NumDescriptors

Tipo: UINT

O número de descritores a serem copiados.

[in] DestDescriptorRangeStart

Tipo: D3D12_CPU_DESCRIPTOR_HANDLE

Um D3D12_CPU_DESCRIPTOR_HANDLE que descreve os descritores de destino para os quais começar a copiar.

Os descritores de destino e de origem devem estar em heaps do mesmo D3D12_DESCRIPTOR_HEAP_TYPE.

[in] SrcDescriptorRangeStart

Tipo: D3D12_CPU_DESCRIPTOR_HANDLE

Um D3D12_CPU_DESCRIPTOR_HANDLE que descreve os descritores de origem dos quais começar a copiar.

Importante

O parâmetro SrcDescriptorRangeStart deve estar em um heap de descritor não visível para sombreador. Isso ocorre porque os heaps de descritor visíveis do sombreador podem ser criados na memória WRITE_COMBINE ou na memória local da GPU, o que é proibitivamente lento para leitura. Se o aplicativo gerenciar heaps de descritor por meio da cópia dos descritores necessários para um determinado passe ou quadro de heaps de descritor local de "armazenamento" para o heap de descritor associado à GPU, use heaps opacos de sombreador para os heaps de armazenamento e copie para o heap visível por GPU, conforme necessário.

[in] DescriptorHeapsType

Tipo: D3D12_DESCRIPTOR_HEAP_TYPE

O valor tipado D3D12_DESCRIPTOR_HEAP_TYPE que especifica o tipo de heap de descritor com o qual copiar. Isso é necessário, pois diferentes tipos de descritor podem ter tamanhos diferentes.

Os heaps de descritor de origem e de destino devem ter o mesmo tipo, caso contrário, a camada de depuração emitirá um erro.

Valor retornado

Nenhum

Comentários

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

Requisitos

   
Plataforma de Destino Windows
Cabeçalho d3d12.h
Biblioteca D3D12.lib
DLL D3D12.dll

Confira também

Copiar descritores

ID3D12Device