> ## 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 exigences en ressources pour générer une structure d'accélération.

Équivalent à [GetRaytracingAccelerationStructurePrebuildInfo](https://learn.microsoft.com/en-us/windows/win32/api/d3d12/nf-d3d12-id3d12device5-getraytracingaccelerationstructureprebuildinfo), sauf qu'il tient compte des options supplémentaires appliquées à la structure d'accélération lorsqu'elle est générée avec [BuildRaytracingAccelerationStructureBatched2X](/fr-CA/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 nul.
</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 génération 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, sauf 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. Autrement dit, le calcul des exigences en ressources pour la structure d'accélération ne dépend pas des données géométriques réelles (comme 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.

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

Spécifie la taille et l'emplacement d'un blob de données qui peut ê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 au processus de génération de la structure d'accélération.

Consultez l'exemple 1 dans [BuildRaytracingAccelerationStructureBatched2X](/fr-CA/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égénération et de génération 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-CA/reference/graphics/d3d12_xs/interfaces/ID3D12Device8/id3d12device8)


## Related topics

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