> ## 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

> Permet à l'utilisateur de préconstruire le BVH et permet au pilote de l'organiser en mémoire avec les données auxiliaires.

Il s'agit d'une API qui permet à l'utilisateur de préconstruire le BVH et qui permet au pilote de l'organiser en mémoire avec les données auxiliaires. Cette API est utilisée en interne par le générateur de BVH sur le processeur. Les développeurs peuvent également utiliser cette même API s'ils souhaitent construire une hiérarchie personnalisée.

## Syntaxe

```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  
)  
```

### Paramètres

*pDesc*   \_In\_\
Type : D3D12\_BUILD\_RAYTRACING\_ACCELERATION\_STRUCTURE\_DESC\*

Structure D3D12 standard décrivant le BVH à construire.

*pRootNode*   \_In\_\
Type : [D3D12XBOX\_RAYTRACING\_CANONICAL\_ACCELERATION\_STRUCTURE\_NODE\*](/fr-CA/reference/graphics/d3d12_xs/structs/d3d12xbox_raytracing_canonical_acceleration_structure_node)

Nœud racine du BVH

*pHierarchyNodes*   \_In\_opt\_\
Type : [D3D12XBOX\_RAYTRACING\_CANONICAL\_ACCELERATION\_STRUCTURE\_NODE\*](/fr-CA/reference/graphics/d3d12_xs/structs/d3d12xbox_raytracing_canonical_acceleration_structure_node)

Nœuds intérieurs du BVH

*NumHierarchyNodes*   \_In\_\
Type : UINT

Nombre de nœuds intérieurs du BVH

*pLeafNodes*   \_In\_opt\_\
Type : [D3D12XBOX\_RAYTRACING\_CANONICAL\_ACCELERATION\_STRUCTURE\_NODE\*](/fr-CA/reference/graphics/d3d12_xs/structs/d3d12xbox_raytracing_canonical_acceleration_structure_node)

Nœuds feuilles du BVH

*NumLeafNodes*   \_In\_\
Type : UINT

Nombre de nœuds feuilles du BVH

*NumPostbuildInfoDescs*   \_In\_\
Type : UINT

Nombre de descripteurs d'informations post-construction à remplir, comme dans l'API standard

*pPostbuildInfoDescs*   \_In\_reads\_opt\_(NumPostbuildInfoDescs)\
Type : D3D12\_RAYTRACING\_ACCELERATION\_STRUCTURE\_POSTBUILD\_INFO\_DESC\*

Liste des descripteurs d'informations post-construction

### Valeur renvoyée

Type : void

## Remarques

Organise le BVH en mémoire selon la hiérarchie d'entrée. Les structures XDXR internes sont gérées en conséquence.

## Configuration requise

**En-tête :** d3d12\_xs.h

**Bibliothèque :** d3d12\_xs.lib\
**Plateformes prises en charge** : consoles XBOX Series

## Voir aussi

[ID3D12GraphicsCommandList4](/fr-CA/reference/graphics/d3d12_xs/interfaces/ID3D12GraphicsCommandList4/id3d12graphicscommandlist4)


## Related topics

- [Répertoire des rubriques NDA : liens actifs vers Microsoft Learn](/fr-CA/nda/nda-topic-directory.md)
- [D3D12_BUILD_RAYTRACING_ACCELERATION_STRUCTURE_DESC](/fr-CA/reference/graphics/d3d12/structs/d3d12_build_raytracing_acceleration_structure_desc_public.md)
- [BuildRaytracingAccelerationStructure (consoles XBOX Series)](/fr-CA/reference/graphics/d3d12/interfaces/id3d12graphicscommandlist4/methods/id3d12graphicscommandlist4_buildraytracingaccelerationstructure_public.md)
- [D3D12_BUILD_RAYTRACING_ACCELERATION_STRUCTURE_INPUTS](/fr-CA/reference/graphics/d3d12/structs/d3d12_build_raytracing_acceleration_structure_inputs_public.md)
- [D3D12_BUILD_RAYTRACING_ACCELERATION_STRUCTURE_TOOLS_VISUALIZATION_HEADER (consoles XBOX Series)](/fr-CA/reference/graphics/d3d12/structs/d3d12_build_raytracing_acceleration_structure_tools_visualization_header_public.md)