ID3D12GraphicsCommandList4::EmitRaytracingAccelerationStructurePostbuildInfo method (d3d12.h)

Emits post-build properties for a set of acceleration structures. This enables applications to know the output resource requirements for performing acceleration structure operations via ID3D12GraphicsCommandList4::CopyRaytracingAccelerationStructure.

Syntax

void EmitRaytracingAccelerationStructurePostbuildInfo(
  [in] const D3D12_RAYTRACING_ACCELERATION_STRUCTURE_POSTBUILD_INFO_DESC *pDesc,
  [in] UINT                                                              NumSourceAccelerationStructures,
  [in] const D3D12_GPU_VIRTUAL_ADDRESS                                   *pSourceAccelerationStructureData
);

Parameters

[in] pDesc

A D3D12_RAYTRACING_ACCELERATION_STRUCTURE_POSTBUILD_INFO_DESC object describing post-build information to generate.

[in] NumSourceAccelerationStructures

Number of pointers to acceleration structure GPU virtual addresses pointed to by pSourceAccelerationStructureData. This number also affects the destination (output), which will be a contiguous array of NumSourceAccelerationStructures output structures, where the type of the structures depends on InfoType field of the supplied in the pDesc description.

[in] pSourceAccelerationStructureData

Pointer to array of GPU virtual addresses of size NumSourceAccelerationStructures.

The address must be aligned to 256 bytes, defined as D3D12_RAYTRACING_ACCELERATION_STRUCTURE_BYTE_ALIGNMENT.

The memory pointed to must be in state D3D12_RESOURCE_STATE_RAYTRACING_ACCELERATION_STRUCTURE.

Return value

None

Remarks

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

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