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

> Permite que o usuário pré-construa a BVH e permite que o driver a disponha na memória junto com os dados auxiliares.

Esta é uma API que permite que o usuário pré-construa a BVH e permite que o driver a disponha na memória junto com os dados auxiliares. Essa API é usada internamente pelo construtor de BVH da CPU. A mesma API também pode ser usada pelos desenvolvedores, caso se deseje construir uma hierarquia personalizada.

## Sintaxe

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

### Parâmetros

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

Estrutura padrão do D3D12 que descreve a BVH a ser construída.

*pRootNode*   \_In\_\
Tipo: [D3D12XBOX\_RAYTRACING\_CANONICAL\_ACCELERATION\_STRUCTURE\_NODE\*](/pt-BR/reference/graphics/d3d12_xs/structs/d3d12xbox_raytracing_canonical_acceleration_structure_node)

Nó raiz da BVH

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

Nós internos da BVH

*NumHierarchyNodes*   \_In\_\
Tipo: UINT

O número de nós internos da BVH

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

Nós folha da BVH

*NumLeafNodes*   \_In\_\
Tipo: UINT

O número de nós folha da BVH

*NumPostbuildInfoDescs*   \_In\_\
Tipo: UINT

Número de descs de informações pós-construção a serem preenchidas, como na API padrão

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

Lista de descs de informações pós-construção

### Valor retornado

Tipo: void

## Comentários

Dispõe a BVH na memória seguindo a hierarquia de entrada. As estruturas internas do XDXR são tratadas adequadamente.

## Requisitos

**Cabeçalho:** d3d12\_xs.h

**Biblioteca:** d3d12\_xs.lib\
**Plataformas compatíveis**: consoles XBOX Series

## Confira também

[ID3D12GraphicsCommandList4](/pt-BR/reference/graphics/d3d12_xs/interfaces/ID3D12GraphicsCommandList4/id3d12graphicscommandlist4)


## Related topics

- [D3D12_BUILD_RAYTRACING_ACCELERATION_STRUCTURE_DESC](/reference/graphics/d3d12/structs/d3d12_build_raytracing_acceleration_structure_desc_public.md)
- [D3D12_BUILD_RAYTRACING_ACCELERATION_STRUCTURE_INPUTS](/reference/graphics/d3d12/structs/d3d12_build_raytracing_acceleration_structure_inputs_public.md)
- [BuildRaytracingAccelerationStructure (XBOX Series consoles)](/reference/graphics/d3d12/interfaces/id3d12graphicscommandlist4/methods/id3d12graphicscommandlist4_buildraytracingaccelerationstructure_public.md)
- [BuildRaytracingAccelerationStructure (consolas XBOX Series)](/es/reference/graphics/d3d12/interfaces/id3d12graphicscommandlist4/methods/id3d12graphicscommandlist4_buildraytracingaccelerationstructure_public.md)