Skip to main content
将源加速结构复制到目标内存,同时应用指定的变换。

语法

参数

DestAccelerationStructureData [in]
类型:D3D12_GPU_VIRTUAL_ADDRESS
目标内存。如果指定的 Mode 需要,可以通过事先调用 EmitRaytracingAccelerationStructurePostbuildInfo 来获知所需大小。 无论指定的 Mode 如何,目标起始地址必须按 256 字节对齐,即 D3D12_RAYTRACING_ACCELERATION_STRUCTURE_BYTE_ALIGNMENT 中定义的值。 目标内存范围不能与源重叠。否则,结果未定义。 所指向内存必须处于的资源状态取决于 Mode 参数。有关更多信息,请参阅 D3D12_RAYTRACING_ACCELERATION_STRUCTURE_COPY_MODE SourceAccelerationStructureData [in]
类型:D3D12_GPU_VIRTUAL_ADDRESS
要根据指定的 Mode 复制/变换的加速结构或其他类型数据的地址。数据保持不变且可用。该操作仅复制 SourceAccelerationStructureData 所指向的数据,而不复制任何其他数据(例如加速结构),即使源数据可能指向这些数据。例如,对于顶层加速结构,其指向的任何底层加速结构在操作中都不会被复制。 无论指定的 Mode 如何,源内存必须按 256 字节对齐,即 D3D12_RAYTRACING_ACCELERATION_STRUCTURE_BYTE_ALIGNMENT 中定义的值。 所指向内存必须处于的资源状态取决于 Mode 参数。有关更多信息,请参阅 D3D12_RAYTRACING_ACCELERATION_STRUCTURE_COPY_MODE Mode [in]
类型:D3D12_RAYTRACING_ACCELERATION_STRUCTURE_COPY_MODE
要执行的复制操作的类型。有关更多信息,请参阅 D3D12_RAYTRACING_ACCELERATION_STRUCTURE_COPY_MODE

返回值

类型:void 无。

备注

由于光线跟踪加速结构可能包含内部指针并具有设备相关的不透明布局,因此复制它们或以其他方式操纵它们需要专用 API,以便驱动程序可以处理请求的操作。 此方法可以从图形或计算命令列表调用,但不能从捆绑包调用。

要求

头文件: d3d12_xs.h
库: d3d12_xs.lib
支持的平台:XBOX Series 主机

另请参阅

ID3D12GraphicsCommandList4
最后修改于 2026年8月24日