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

# GetRaytracingAccelerationStructurePrebuildInfoX

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

Équivalent de [GetRaytracingAccelerationStructurePrebuildInfo](https://learn.microsoft.com/en-us/windows/win32/api/d3d12/nf-d3d12-id3d12device5-getraytracingaccelerationstructureprebuildinfo), à ceci près qu'elle tient compte des options supplémentaires appliquées à la structure d'accélération lorsqu'elle est construite avec [BuildRaytracingAccelerationStructureBatched2X](/fr/reference/graphics/d3d12_xs/interfaces/ID3D12GraphicsCommandList6/methods/id3d12graphicscommandlist6_buildraytracingaccelerationstructurebatched2x).

<Note>
  Cette fonction *doit* être utilisée à la place de [GetRaytracingAccelerationStructurePrebuildInfo](https://learn.microsoft.com/en-us/windows/win32/api/d3d12/nf-d3d12-id3d12device5-getraytracingaccelerationstructureprebuildinfo) lorsque *pExtraOptions* n'est pas null.
</Note>

## Syntaxe

```cpp theme={null}
void GetRaytracingAccelerationStructurePrebuildInfoX(  
         const D3D12_BUILD_RAYTRACING_ACCELERATION_STRUCTURE_INPUTS* pInputs,  
         const D3D12XBOX_XDXR_STREAM_DESC* pExtraOptions,  
         D3D12_RAYTRACING_ACCELERATION_STRUCTURE_PREBUILD_INFO* pInfo  
)  
```

### Paramètres

*pInputs*   \_In\_\
Type : D3D12\_BUILD\_RAYTRACING\_ACCELERATION\_STRUCTURE\_INPUTS\*

Description de la construction de la structure d'accélération. Cette structure est partagée avec les différentes variantes de `BuildRaytracingAccelerationStructure*`. Pour plus d'informations, consultez [D3D12\_BUILD\_RAYTRACING\_ACCELERATION\_STRUCTURE\_INPUTS](https://learn.microsoft.com/en-us/windows/win32/api/d3d12/ns-d3d12-d3d12_build_raytracing_acceleration_structure_inputs).

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 la transformation facultative dans `D3D12_RAYTRACING_GEOMETRY_TRIANGLES_DESC`, sans la déréférencer. En d'autres termes, 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 les positions des sommets), mais uniquement de propriétés globales, telles que le nombre de triangles, le nombre d'instances, etc.

*pExtraOptions*   \_In\_\
Type : [D3D12XBOX\_XDXR\_STREAM\_DESC\*](/fr/reference/graphics/d3d12_xs/structs/d3d12xbox_xdxr_stream_desc)

Spécifie la taille et l'emplacement d'un blob de données pouvant être réinterprété comme une ou plusieurs des structures suivantes :

* `D3D12XBOX_BUILD_RAYTRACING_ACCELERATION_STRUCTURE_PARAMS1`
* `D3D12XBOX_BUILD_RAYTRACING_ACCELERATION_STRUCTURE_PARAMS2`
* `D3D12XBOX_BUILD_RAYTRACING_ACCELERATION_STRUCTURE_PARAMS3`

Ces structures exposent des extensions de fonctionnalités XBOX et des contrôles de plus bas niveau du processus de construction de la structure d'accélération.

Consultez l'exemple 1 dans [BuildRaytracingAccelerationStructureBatched2X](/fr/reference/graphics/d3d12_xs/interfaces/ID3D12GraphicsCommandList6/methods/id3d12graphicscommandlist6_buildraytracingaccelerationstructurebatched2x) pour un exemple complet de création de ce blob, d'interrogation des tailles de préconstruction et de construction d'un BVH à l'aide d'options supplémentaires.

*pInfo*   \_Out\_\
Type : D3D12\_RAYTRACING\_ACCELERATION\_STRUCTURE\_PREBUILD\_INFO\*

Résultat de la requête.

### Valeur de retour

Type : void

## Remarques

Consultez la description de `GetRaytracingAccelerationStructurePrebuildInfo` pour plus d'informations sur l'objectif de cette fonction. Cette variante est propre à XBOX et doit être utilisée avec `BuildRaytracingAccelerationStructureBatched2X` lorsqu'une valeur est fournie pour *pExtraOptions*.

## Configuration requise

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

## Voir aussi

[ID3D12Device8](/fr/reference/graphics/d3d12_xs/interfaces/ID3D12Device8/id3d12device8)


## Related topics

- [Répertoire des rubriques NDA : liens actifs vers Microsoft Learn](/fr/nda/nda-topic-directory.md)
- [GetRaytracingAccelerationStructurePrebuildInfo](/fr/reference/graphics/d3d12/interfaces/id3d12device5/methods/id3d12device5_getraytracingaccelerationstructureprebuildinfo_public.md)
- [D3D12_RAYTRACING_ACCELERATION_STRUCTURE_PREBUILD_INFO](/fr/reference/graphics/d3d12/structs/d3d12_raytracing_acceleration_structure_prebuild_info_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_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)