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

Copia descriptores de un origen en un destino.

Sintaxis

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

Número de descriptores que se van a copiar.

[in] DestDescriptorRangeStart

Tipo: D3D12_CPU_DESCRIPTOR_HANDLE

Un D3D12_CPU_DESCRIPTOR_HANDLE que describe los descriptores de destino en los que se va a empezar a copiar.

Los descriptores de origen y de destino deben estar en montones del mismo D3D12_DESCRIPTOR_HEAP_TYPE.

[in] SrcDescriptorRangeStart

Tipo: D3D12_CPU_DESCRIPTOR_HANDLE

Un D3D12_CPU_DESCRIPTOR_HANDLE que describe los descriptores de origen desde los que se va a empezar a copiar.

Importante

El parámetro SrcDescriptorRangeStart debe estar en un montón de descriptores no visibles para sombreador. Esto se debe a que los montones de descriptores visibles para sombreador se pueden crear en WRITE_COMBINE memoria o memoria local de GPU, lo que es prohibitivamente lento de leer. Si la aplicación administra montones de descriptores mediante la copia de los descriptores necesarios para un paso o marco determinado desde montones de descriptores de "almacenamiento" locales al montón de descriptores enlazados a GPU, use montones de sombreador opacos para los montones de almacenamiento y cópielo en el montón visible para GPU según sea necesario.

[in] DescriptorHeapsType

Tipo: D3D12_DESCRIPTOR_HEAP_TYPE

Valor con tipo D3D12_DESCRIPTOR_HEAP_TYPE que especifica el tipo de montón de descriptores con el que se va a copiar. Esto es necesario, ya que los distintos tipos de descriptores pueden tener tamaños diferentes.

Tanto los montones de descriptores de origen como de destino deben tener el mismo tipo; de lo contrario, la capa de depuración emitirá un error.

Valor devuelto

Ninguno

Observaciones

Si procede, prefiere este método a ID3D12Device::CopyDescriptors. Puede tener una mejor tasa de errores de caché de CPU debido a la naturaleza lineal de la copia.

Requisitos

Plataforma de destino	Windows
Encabezado	d3d12.h
Library	D3D12.lib
Archivo DLL	D3D12.dll

Consulte también

Descriptores de copias

ID3D12Device