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 |