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

# D3D12XBOX_BUILD_RAYTRACING_ACCELERATION_STRUCTURE_PARAMS1

> D3D12XBOX_BUILD_RAYTRACING_ACCELERATION_STRUCTURE_PARAMS1 (consoles XBOX Series) — Ensemble étendu de paramètres pour les générations par lots.

Ensemble étendu de paramètres pour les générations par lots introduit dans le GDK d'août 2020.

## Syntaxe

```cpp theme={null}
typedef struct D3D12XBOX_BUILD_RAYTRACING_ACCELERATION_STRUCTURE_PARAMS1 {  
    D3D12XBOX_BUILD_RAYTRACING_ACCELERATION_STRUCTURE_SUBOBJECT_TYPE Type;  
    float QuadJoinThreshold;  
    float FP16BoxInflationThreshold;  
    BYTE TreeletFirstLevel;  
    BYTE TreeletNumLevels;  
    BYTE TreeletStepSizeBetweenRounds;  
    BYTE TreeletRoundsLimiter;  
} D3D12XBOX_BUILD_RAYTRACING_ACCELERATION_STRUCTURE_PARAMS1  
```

### Membres

*Type*\
Type : [D3D12XBOX\_BUILD\_RAYTRACING\_ACCELERATION\_STRUCTURE\_SUBOBJECT\_TYPE](/fr-CA/reference/graphics/d3d12_xs/enums/d3d12xbox_build_raytracing_acceleration_structure_subobject_type)

Doit être D3D12XBOX\_BUILD\_RAYTRACING\_ACCELERATION\_STRUCTURE\_SUBOBJECT\_TYPE\_PARAMS1

*QuadJoinThreshold*\
Type : float

Générateur hors ligne seulement : croissance acceptable de la taille de la boîte en %% pour accepter deux triangles adjacents comme un quadrilatère. Des valeurs élevées fusionneront n'importe quels triangles en quadrilatère, ce qui peut entraîner des régressions de performances. Les valeurs raisonnables sont \[1..2]. Génère toujours des arbres plus petits lorsqu'il est utilisé. Le générateur en ligne tente toujours de créer des quadrilatères.

*FP16BoxInflationThreshold*\
Type : float

Générateurs en ligne et hors ligne. Les deux générateurs peuvent équilibrer la taille et la vitesse de l'arbre en sélectionnant les boîtes F32 et F16 lorsque c'est possible. Erreur de compression->décompression acceptable pour l'utilisation de boîtes F16. Des erreurs plus grandes entraînent une régression des performances, car plus de rayons sont capturés inutilement dans la boîte, mais les arbres seront plus petits. Notez qu'aucun des générateurs n'acceptera une boîte F16 si elle est hors plage après la conversion; il peut donc être judicieux de centrer les maillages autour du centre de masse.

*TreeletFirstLevel*\
Type : BYTE

En ligne seulement. Premier niveau de l'arbre où Treelet commence ses itérations ascendantes.

*TreeletNumLevels*\
Type : BYTE

En ligne seulement. Nombre de niveaux que Treelet doit parcourir.

*TreeletStepSizeBetweenRounds*\
Type : BYTE

En ligne seulement. Multiplicateur de pas pour sauter des niveaux de l'arbre pendant l'ascension

*TreeletRoundsLimiter*\
Type : BYTE

En ligne seulement. Limiteur global de tours; zéro désactive les treelets.

## Remarques

Utilisez [D3D12XboxMakeDefault\_D3D12XBOX\_BUILD\_RAYTRACING\_ACCELERATION\_STRUCTURE\_PARAMS1](/fr-CA/reference/graphics/d3d12_xs/functions/d3d12xboxmakedefault_d3d12xbox_build_raytracing_acceleration_structure_params1) pour définir cette structure à ses valeurs par défaut avant de remplacer les membres choisis. N'initialisez pas cette structure à zéro.

Lorsque vous utilisez des paramètres étendus, [ID3D12Device8::GetRaytracingAccelerationStructurePrebuildInfoX](/fr-CA/reference/graphics/d3d12_xs/interfaces/ID3D12Device8/methods/id3d12device8_getraytracingaccelerationstructureprebuildinfox) doit être utilisé au lieu de `GetRaytracingAccelerationStructurePrebuildInfo`. Les tailles de mémoire BVH ou de mémoire de travail peuvent différer et entraîner une corruption du tas et des blocages du GPU si elles ne sont pas correctement allouées.

Consultez les exemples d'utilisation dans [BuildRaytracingAccelerationStructureBatched2X](/fr-CA/reference/graphics/d3d12_xs/interfaces/ID3D12GraphicsCommandList6/methods/id3d12graphicscommandlist6_buildraytracingaccelerationstructurebatched2x).

## Configuration requise

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

## Voir aussi

[D3D12XboxMakeDefault\_D3D12XBOX\_BUILD\_RAYTRACING\_ACCELERATION\_STRUCTURE\_PARAMS1](/fr-CA/reference/graphics/d3d12_xs/functions/d3d12xboxmakedefault_d3d12xbox_build_raytracing_acceleration_structure_params1)\
[BuildRaytracingAccelerationStructureBatched2X](/fr-CA/reference/graphics/d3d12_xs/interfaces/ID3D12GraphicsCommandList6/methods/id3d12graphicscommandlist6_buildraytracingaccelerationstructurebatched2x)\
[d3d12\_xs](/fr-CA/reference/graphics/d3d12_xs/d3d12_xs_members)


## Related topics

- [Répertoire des rubriques NDA : liens actifs vers Microsoft Learn](/fr-CA/nda/nda-topic-directory.md)
- [D3D12_BUILD_RAYTRACING_ACCELERATION_STRUCTURE_DESC](/fr-CA/reference/graphics/d3d12/structs/d3d12_build_raytracing_acceleration_structure_desc_public.md)
- [D3D12_BUILD_RAYTRACING_ACCELERATION_STRUCTURE_INPUTS](/fr-CA/reference/graphics/d3d12/structs/d3d12_build_raytracing_acceleration_structure_inputs_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_DESC](/fr-CA/reference/graphics/d3d12/structs/d3d12_raytracing_acceleration_structure_postbuild_info_desc_public.md)