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

# GetRaytracingAccelerationStructurePrebuildInfo

> Interroge le pilote sur les ressources requises pour générer une structure d'accélération.

Interroge le pilote sur les ressources requises pour générer une structure d'accélération.

## Syntaxe

```cpp theme={null}
void GetRaytracingAccelerationStructurePrebuildInfo(
    const D3D12_BUILD_RAYTRACING_ACCELERATION_STRUCTURE_INPUTS  pDesc,
    D3D12_RAYTRACING_ACCELERATION_STRUCTURE_PREBUILD_INFO  pInfo
)
```

### Paramètres

*pDesc \[in]*\
Type : const D3D12\_BUILD\_RAYTRACING\_ACCELERATION\_STRUCTURE\_INPUTS \*

Description de la génération de la structure d'accélération. Cette structure est partagée avec [BuildRaytracingAccelerationStructure](/fr/reference/graphics/d3d12/interfaces/id3d12graphicscommandlist4/methods/id3d12graphicscommandlist4_buildraytracingaccelerationstructure_public).  Pour plus d'informations, consultez [D3D12\_BUILD\_RAYTRACING\_ACCELERATION\_STRUCTURE\_INPUTS](/fr/reference/graphics/d3d12/structs/d3d12_build_raytracing_acceleration_structure_inputs_public).

L'implémentation est autorisée à examiner tous les paramètres CPU de cette structure et des structures imbriquées.  Elle ne peut pas inspecter ni déréférencer d'adresses virtuelles GPU, si ce n'est pour vérifier si un pointeur est NULL ou non, comme pour la transformation facultative dans [D3D12\_RAYTRACING\_GEOMETRY\_TRIANGLES\_DESC](/fr/reference/graphics/d3d12/structs/d3d12_raytracing_geometry_triangles_desc_public), sans la déréférencer. Autrement dit, le calcul des ressources requises pour la structure d'accélération ne dépend pas des données de géométrie réelles (telles que les positions des sommets) ; il ne peut dépendre que de propriétés globales, comme le nombre de triangles, le nombre d'instances, etc.

*pInfo \[out]*\
Type : D3D12\_RAYTRACING\_ACCELERATION\_STRUCTURE\_PREBUILD\_INFO \*

Résultat de la requête.

### Valeur renvoyée

Type : void

Aucune.

## Remarques

La description de la structure d'accélération en entrée est identique à celle passée à [BuildRaytracingAccelerationStructure](/fr/reference/graphics/d3d12/interfaces/id3d12graphicscommandlist4/methods/id3d12graphicscommandlist4_buildraytracingaccelerationstructure_public). Le résultat de cette fonction permet à l'application de fournir la quantité correcte de stockage de sortie et de stockage temporaire à **BuildRaytracingAccelerationStructure** pour la même géométrie.

Les générations peuvent également être effectuées avec la même configuration globale que celle passée à **GetAccelerationStructurePrebuildInfo**, à l'exception de nombres égaux ou inférieurs de géométries/instances ou de sommets/index/AABB dans une géométrie donnée.  Dans ce cas, les besoins de stockage signalés avec les tailles d'origine passées à **GetRaytracingAccelerationStructurePrebuildInfo** restent valides : la génération peut consommer moins d'espace, mais jamais plus.  Cela est pratique dans les scénarios d'application où il est acceptable d'allouer un stockage volontairement surdimensionné pour les structures d'accélération.

Cette méthode se trouve sur l'interface de l'appareil plutôt que sur la liste de commandes, en partant du principe que les pilotes doivent pouvoir calculer les ressources requises pour la génération d'une structure d'accélération en examinant uniquement les parties de l'appel visibles par le CPU, sans avoir à déréférencer de pointeurs vers la mémoire GPU contenant les données réelles de sommets, d'index, etc.

## Configuration requise

**En-tête :** d3d12\_xs.h\
**Bibliothèque :** d3d12\_xs.lib\
**Plateformes prises en charge :** consoles XBOX Series

## Voir aussi

[ID3D12Device5](/fr/reference/graphics/d3d12/interfaces/id3d12device5/id3d12device5_public)


## Related topics

- [D3D12_RAYTRACING_ACCELERATION_STRUCTURE_PREBUILD_INFO](/fr/reference/graphics/d3d12/structs/d3d12_raytracing_acceleration_structure_prebuild_info_public.md)
- [D3D12_BUILD_RAYTRACING_ACCELERATION_STRUCTURE_INPUTS](/fr/reference/graphics/d3d12/structs/d3d12_build_raytracing_acceleration_structure_inputs_public.md)
- [D3D12_RAYTRACING_ACCELERATION_STRUCTURE_POSTBUILD_INFO_CURRENT_SIZE_DESC (consoles XBOX Series)](/fr/reference/graphics/d3d12/structs/d3d12_raytracing_acceleration_structure_postbuild_info_current_size_desc_public.md)
- [D3D12_BUILD_RAYTRACING_ACCELERATION_STRUCTURE_DESC](/fr/reference/graphics/d3d12/structs/d3d12_build_raytracing_acceleration_structure_desc_public.md)
- [D3D12_RAYTRACING_ACCELERATION_STRUCTURE_POSTBUILD_INFO_COMPACTED_SIZE_DESC (consoles XBOX Series)](/fr/reference/graphics/d3d12/structs/d3d12_raytracing_acceleration_structure_postbuild_info_compacted_size_desc_public.md)