Skip to main content
描述光线追踪加速结构。将此结构传递给 ID3D12GraphicsCommandList4::BuildRaytracingAccelerationStructure 以描述要构建的加速结构。

​
语法

​
成员

DestAccelerationStructureData
类型：D3D12_GPU_VIRTUAL_ADDRESS 存储所构建的加速结构的位置。ID3D12Device5::GetRaytracingAccelerationStructurePrebuildInfo 根据给定的一组加速结构构建参数在此处报告结果所需的内存量。 该地址必须按 256 字节对齐，其定义为 D3D12_RAYTRACING_ACCELERATION_STRUCTURE_BYTE_ALIGNMENT。
该内存必须处于 D3D12_RESOURCE_STATE_RAYTRACING_ACCELERATION_STRUCTURE 状态。
Inputs
类型：D3D12_BUILD_RAYTRACING_ACCELERATION_STRUCTURE_INPUTS 用于加速结构构建的输入数据描述。该数据存储在一个单独的结构中，因为它也与 GetRaytracingAccelerationStructurePrebuildInfo 一起使用。 SourceAccelerationStructureData
类型：D3D12_GPU_VIRTUAL_ADDRESS 如果请求加速结构更新（增量构建），即在 Flags 参数中设置了 D3D12_RAYTRACING_ACCELERATION_STRUCTURE_BUILD_FLAG_PERFORM_UPDATE，则为现有加速结构的地址。否则，此地址必须为 NULL。 如果此地址与 DestAccelerationStructureData 相同，则以就地方式执行更新。源内存与目标内存的任何其他形式的重叠都是无效的，会产生未定义行为。 该地址必须按 256 字节对齐，其定义为 D3D12_RAYTRACING_ACCELERATION_STRUCTURE_BYTE_ALIGNMENT，因为此处传入的任何现有加速结构在放置时已被要求使用此对齐，所以此项应自动满足。
该内存必须处于 D3D12_RESOURCE_STATE_RAYTRACING_ACCELERATION_STRUCTURE 状态。

​
ScratchAccelerationStructureData

构建将在其中存储临时数据的位置。GetRaytracingAccelerationStructurePrebuildInfo 根据一组给定的加速结构构建参数报告实现所需的暂存内存量。
该内存必须处于 D3D12_RESOURCE_STATE_UNORDERED_ACCESS 状态。
ScratchAccelerationStructureData
类型：D3D12_GPU_VIRTUAL_ADDRESS

​
要求

头文件： d3d12_xs.h
库： d3d12_xs.lib
支持的平台：XBOX Series 主机
最后修改于 2026年8月24日

相关主题

BuildRaytracingAccelerationStructure (XBOX Series 主机)D3D12_BUILD_RAYTRACING_ACCELERATION_STRUCTURE_INPUTSD3D12_RAYTRACING_ACCELERATION_STRUCTURE_POSTBUILD_INFO_DESCD3D12_BUILD_RAYTRACING_ACCELERATION_STRUCTURE_TOOLS_VISUALIZATION_HEADER (XBOX Series consoles)D3D12_RAYTRACING_ACCELERATION_STRUCTURE_POSTBUILD_INFO_SERIALIZATION_DESC (XBOX Series consoles)