Método ID3D12GraphicsCommandList4::CopyRaytracingAccelerationStructure (d3d12.h)

Copia una estructura de aceleración de origen en la memoria de destino mientras se aplica la transformación especificada.

Sintaxis

void CopyRaytracingAccelerationStructure(
  [in] D3D12_GPU_VIRTUAL_ADDRESS                         DestAccelerationStructureData,
  [in] D3D12_GPU_VIRTUAL_ADDRESS                         SourceAccelerationStructureData,
  [in] D3D12_RAYTRACING_ACCELERATION_STRUCTURE_COPY_MODE Mode
);

Parámetros

[in] DestAccelerationStructureData

Memoria de destino. El tamaño necesario se puede detectar llamando a EmitRaytracingAccelerationStructurePostbuildInfo de antemano, si es necesario para el modo especificado.

La dirección de inicio de destino debe alinearse con 256 bytes, definidas como D3D12_RAYTRACING_ACCELERATION_STRUCTURE_BYTE_ALIGNMENT, independientemente del modo especificado.

El intervalo de memoria de destino no puede superponerse al origen. De lo contrario, los resultados no están definidos.

El estado de recurso al que apunta la memoria debe estar en depende del parámetro Mode . Para obtener más información, consulte D3D12_RAYTRACING_ACCELERATION_STRUCTURE_COPY_MODE.

[in] SourceAccelerationStructureData

Dirección de la estructura de aceleración u otro tipo de datos que se van a copiar o transformar en función del modo especificado. Los datos permanecen inalterados y utilizables. La operación solo copia los datos a los que apunta SourceAccelerationStructureData y no a ningún otro dato, como estructuras de aceleración, a los que los datos de origen pueden apuntar. Por ejemplo, en el caso de una estructura de aceleración de nivel superior, las estructuras de aceleración de nivel inferior a las que apunta no se copian en la operación.

La memoria de origen debe alinearse con 256 bytes, definida como D3D12_RAYTRACING_ACCELERATION_STRUCTURE_BYTE_ALIGNMENT, independientemente del modo especificado.

El estado de recurso al que apunta la memoria debe estar en depende del parámetro Mode . Para obtener más información, consulte D3D12_RAYTRACING_ACCELERATION_STRUCTURE_COPY_MODE.

[in] Mode

Tipo de operación de copia que se va a realizar. Para obtener más información, consulte D3D12_RAYTRACING_ACCELERATION_STRUCTURE_COPY_MODE.

Valor devuelto

None

Observaciones

Dado que las estructuras de aceleración raytracing pueden contener punteros internos y tener un diseño opaco dependiente del dispositivo, copiarlos alrededor o manipularlos de otro modo requiere una API dedicada para que los controladores puedan controlar la operación solicitada.

Se puede llamar a este método desde listas de comandos de proceso o gráficos, pero no desde agrupaciones.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 10, versión 1809 [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2016 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	d3d12.h
Library	D3D12.lib
Archivo DLL	D3D12.dll

Consulte también

ID3D12GraphicsCommandList4