Edit

Share via

ID3D12GraphicsCommandList4::BuildRaytracingAccelerationStructure method (d3d12.h)

  • Article

Performs a raytracing acceleration structure build on the GPU and optionally outputs post-build information immediately after the build.

Syntax

void BuildRaytracingAccelerationStructure(
  [in] const D3D12_BUILD_RAYTRACING_ACCELERATION_STRUCTURE_DESC          *pDesc,
  [in] UINT                                                              NumPostbuildInfoDescs,
  [in] const D3D12_RAYTRACING_ACCELERATION_STRUCTURE_POSTBUILD_INFO_DESC *pPostbuildInfoDescs
);

Parameters

[in] pDesc

Description of the acceleration structure to build.

[in] NumPostbuildInfoDescs

Size of the pPostbuildInfoDescs array. Set to 0 if no post-build info is needed.

[in] pPostbuildInfoDescs

Optional array of descriptions for post-build info to generate describing properties of the acceleration structure that was built.

Return value

None

Remarks

This method can be called on graphics or compute command lists but not from bundles.

Post-build information can also be obtained separately from an already built acceleration structure by calling EmitRaytracingAccelerationStructurePostbuildInfo. The advantage of generating post-build info along with a build is that a barrier isn’t needed in between the build completing and requesting post-build information, enabling scenarios where the app needs the post-build info right away.

Requirements

Requirement Value
Minimum supported client Windows 10, version 1809 [desktop apps only]
Minimum supported server Windows Server 2016 [desktop apps only]
Target Platform Windows
Header d3d12.h
Library D3D12.lib
DLL D3D12.dll

See also

ID3D12GraphicsCommandList4