> ## 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-CA/reference/graphics/d3d12/interfaces/id3d12graphicscommandlist4/methods/id3d12graphicscommandlist4_buildraytracingaccelerationstructure_public).  Pour plus d'informations, consultez [D3D12\_BUILD\_RAYTRACING\_ACCELERATION\_STRUCTURE\_INPUTS](/fr-CA/reference/graphics/d3d12/structs/d3d12_build_raytracing_acceleration_structure_inputs_public).

L'implémentation peut 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, sauf pour vérifier si un pointeur est NULL ou non, comme la transformation facultative dans [D3D12\_RAYTRACING\_GEOMETRY\_TRIANGLES\_DESC](/fr-CA/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 géométriques réelles (comme la position 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 \*

Le résultat de la requête.

### Valeur de retour

Type : void

Aucune.

## Remarques

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

Les générations peuvent aussi être effectuées avec la même configuration que celle passée à **GetAccelerationStructurePrebuildInfo**, sauf pour des nombres égaux ou inférieurs de géométries/instances ou de sommets/indices/AABB dans une géométrie donnée.  Dans ce cas, les exigences de stockage signalées avec les tailles d'origine passées à **GetRaytracingAccelerationStructurePrebuildInfo** demeurent valides; la génération peut consommer moins d'espace, mais jamais plus.  C'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 du périphérique plutôt que sur la liste de commandes, car on suppose 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'indices, 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-CA/reference/graphics/d3d12/interfaces/id3d12device5/id3d12device5_public)


## Related topics

- [D3D12_RAYTRACING_ACCELERATION_STRUCTURE_PREBUILD_INFO](/fr-CA/reference/graphics/d3d12/structs/d3d12_raytracing_acceleration_structure_prebuild_info_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_DESC](/fr-CA/reference/graphics/d3d12/structs/d3d12_build_raytracing_acceleration_structure_desc_public.md)
- [D3D12_RAYTRACING_ACCELERATION_STRUCTURE_POSTBUILD_INFO_CURRENT_SIZE_DESC (consoles XBOX Series)](/fr-CA/reference/graphics/d3d12/structs/d3d12_raytracing_acceleration_structure_postbuild_info_current_size_desc_public.md)
- [D3D12_RAYTRACING_ACCELERATION_STRUCTURE_POSTBUILD_INFO_COMPACTED_SIZE_DESC (consoles XBOX Series)](/fr-CA/reference/graphics/d3d12/structs/d3d12_raytracing_acceleration_structure_postbuild_info_compacted_size_desc_public.md)