> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# BuildRaytracingAccelerationStructureFromCanonicalBVH

> 允許使用者預先建置 BVH，並讓驅動程式將其與輔助資料一起配置在記憶體中。

此 API 允許使用者預先建置 BVH，並讓驅動程式將其與輔助資料一起配置在記憶體中。此 API 由 CPU BVH 建置器在內部使用。如果需要建置自訂階層，開發人員也可以使用相同的 API。

## 語法

```cpp theme={null}
void BuildRaytracingAccelerationStructureFromCanonicalBVH(  
         const D3D12_BUILD_RAYTRACING_ACCELERATION_STRUCTURE_DESC* pDesc,  
         const D3D12XBOX_RAYTRACING_CANONICAL_ACCELERATION_STRUCTURE_NODE* pRootNode,  
         const D3D12XBOX_RAYTRACING_CANONICAL_ACCELERATION_STRUCTURE_NODE* pHierarchyNodes,  
         UINT NumHierarchyNodes,  
         const D3D12XBOX_RAYTRACING_CANONICAL_ACCELERATION_STRUCTURE_NODE* pLeafNodes,  
         UINT NumLeafNodes,  
         UINT NumPostbuildInfoDescs,  
         const D3D12_RAYTRACING_ACCELERATION_STRUCTURE_POSTBUILD_INFO_DESC* pPostbuildInfoDescs  
)  
```

### 參數

*pDesc*   \_In\_\
類型：D3D12\_BUILD\_RAYTRACING\_ACCELERATION\_STRUCTURE\_DESC\*

描述要建置之 BVH 的標準 D3D12 結構。

*pRootNode*   \_In\_\
類型：[D3D12XBOX\_RAYTRACING\_CANONICAL\_ACCELERATION\_STRUCTURE\_NODE\*](/zh-TW/reference/graphics/d3d12_xs/structs/d3d12xbox_raytracing_canonical_acceleration_structure_node)

BVH 的根節點

*pHierarchyNodes*   \_In\_opt\_\
類型：[D3D12XBOX\_RAYTRACING\_CANONICAL\_ACCELERATION\_STRUCTURE\_NODE\*](/zh-TW/reference/graphics/d3d12_xs/structs/d3d12xbox_raytracing_canonical_acceleration_structure_node)

BVH 的內部節點

*NumHierarchyNodes*   \_In\_\
類型：UINT

BVH 的內部節點數目

*pLeafNodes*   \_In\_opt\_\
類型：[D3D12XBOX\_RAYTRACING\_CANONICAL\_ACCELERATION\_STRUCTURE\_NODE\*](/zh-TW/reference/graphics/d3d12_xs/structs/d3d12xbox_raytracing_canonical_acceleration_structure_node)

BVH 葉節點

*NumLeafNodes*   \_In\_\
類型：UINT

BVH 葉節點的數目

*NumPostbuildInfoDescs*   \_In\_\
類型：UINT

要填入的建置後資訊描述數目，與標準 API 相同

*pPostbuildInfoDescs*   \_In\_reads\_opt\_(NumPostbuildInfoDescs)\
類型：D3D12\_RAYTRACING\_ACCELERATION\_STRUCTURE\_POSTBUILD\_INFO\_DESC\*

建置後資訊描述的清單

### 傳回值

類型：void

## 備註

依照輸入階層在記憶體中配置 BVH。內部 XDXR 結構會相應地處理。

## 需求

**標頭：** d3d12\_xs.h

**程式庫：** d3d12\_xs.lib\
**支援的平台：** XBOX Series 主機

## 另請參閱

[ID3D12GraphicsCommandList4](/zh-TW/reference/graphics/d3d12_xs/interfaces/ID3D12GraphicsCommandList4/id3d12graphicscommandlist4)


## Related topics

- [D3D12_BUILD_RAYTRACING_ACCELERATION_STRUCTURE_DESC](/zh-TW/reference/graphics/d3d12/structs/d3d12_build_raytracing_acceleration_structure_desc_public.md)
- [D3D12_BUILD_RAYTRACING_ACCELERATION_STRUCTURE_INPUTS](/zh-TW/reference/graphics/d3d12/structs/d3d12_build_raytracing_acceleration_structure_inputs_public.md)
- [BuildRaytracingAccelerationStructure (XBOX Series 主機)](/zh-TW/reference/graphics/d3d12/interfaces/id3d12graphicscommandlist4/methods/id3d12graphicscommandlist4_buildraytracingaccelerationstructure_public.md)
- [D3D12_BUILD_RAYTRACING_ACCELERATION_STRUCTURE_TOOLS_VISUALIZATION_HEADER (XBOX Series 主機)](/zh-TW/reference/graphics/d3d12/structs/d3d12_build_raytracing_acceleration_structure_tools_visualization_header_public.md)
- [GetRaytracingAccelerationStructurePrebuildInfo](/zh-TW/reference/graphics/d3d12/interfaces/id3d12device5/methods/id3d12device5_getraytracingaccelerationstructureprebuildinfo_public.md)