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

# CopyRaytracingAccelerationStructure (consoles XBOX Series)

> Copie une structure d'accélération source vers la mémoire de destination tout en appliquant la transformation spécifiée.

Copie une structure d'accélération source vers la mémoire de destination tout en appliquant la transformation spécifiée.

## Syntaxe

```cpp theme={null}
void CopyRaytracingAccelerationStructure(
    D3D12_GPU_VIRTUAL_ADDRESS DestAccelerationStructureData,
    D3D12_GPU_VIRTUAL_ADDRESS SourceAccelerationStructureData,
    D3D12_RAYTRACING_ACCELERATION_STRUCTURE_COPY_MODE Mode
)
```

### Paramètres

*DestAccelerationStructureData \[in]*\
Type : D3D12\_GPU\_VIRTUAL\_ADDRESS

Mémoire de destination. La taille requise peut être déterminée en appelant au préalable [EmitRaytracingAccelerationStructurePostbuildInfo](/fr-CA/reference/graphics/d3d12/interfaces/id3d12graphicscommandlist4/methods/id3d12graphicscommandlist4_emitraytracingaccelerationstructurepostbuildinfo_public), si nécessaire pour le <i>Mode</i> spécifié.

L'adresse de début de la destination doit être alignée sur 256 octets, valeur définie par [D3D12\_RAYTRACING\_ACCELERATION\_STRUCTURE\_BYTE\_ALIGNMENT](https://learn.microsoft.com/en-us/windows/desktop/direct3d12/constants), quel que soit le <i>Mode</i> spécifié.

La plage de mémoire de destination ne peut pas chevaucher la source. Sinon, les résultats sont indéfinis.

L'état de ressource dans lequel doit se trouver la mémoire pointée dépend du paramètre <i>Mode</i>. Pour plus d'informations, consultez [D3D12\_RAYTRACING\_ACCELERATION\_STRUCTURE\_COPY\_MODE](/fr-CA/reference/graphics/d3d12/enums/d3d12_raytracing_acceleration_structure_copy_mode_public).

*SourceAccelerationStructureData \[in]*\
Type : D3D12\_GPU\_VIRTUAL\_ADDRESS

Adresse de la structure d'accélération ou d'un autre type de données à copier ou à transformer selon le <i>Mode</i> spécifié. Les données demeurent inchangées et utilisables. L'opération copie uniquement les données pointées par <i>SourceAccelerationStructureData</i> et aucune autre donnée, comme les structures d'accélération, vers lesquelles les données sources peuvent pointer. Par exemple, dans le cas d'une structure d'accélération de niveau supérieur, les structures d'accélération de niveau inférieur vers lesquelles elle pointe ne sont pas copiées lors de l'opération.

La mémoire source doit être alignée sur 256 octets, valeur définie par [D3D12\_RAYTRACING\_ACCELERATION\_STRUCTURE\_BYTE\_ALIGNMENT](https://learn.microsoft.com/en-us/windows/desktop/direct3d12/constants), quel que soit le <i>Mode</i> spécifié.

L'état de ressource dans lequel doit se trouver la mémoire pointée dépend du paramètre <i>Mode</i>. Pour plus d'informations, consultez [D3D12\_RAYTRACING\_ACCELERATION\_STRUCTURE\_COPY\_MODE](/fr-CA/reference/graphics/d3d12/enums/d3d12_raytracing_acceleration_structure_copy_mode_public).

*Mode \[in]*\
Type : D3D12\_RAYTRACING\_ACCELERATION\_STRUCTURE\_COPY\_MODE

Type d'opération de copie à effectuer. Pour plus d'informations, consultez [D3D12\_RAYTRACING\_ACCELERATION\_STRUCTURE\_COPY\_MODE](/fr-CA/reference/graphics/d3d12/enums/d3d12_raytracing_acceleration_structure_copy_mode_public).

### Valeur de retour

Type : void

Aucune.

## Remarques

Étant donné que les structures d'accélération de lancer de rayons peuvent contenir des pointeurs internes et avoir une disposition opaque dépendante de l'appareil, leur copie ou toute autre manipulation nécessite une API dédiée afin que les pilotes puissent gérer l'opération demandée.

Cette méthode peut être appelée à partir de listes de commandes graphiques ou de calcul, mais pas à partir de bundles.

## Configuration requise

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

## Voir aussi

[ID3D12GraphicsCommandList4](/fr-CA/reference/graphics/d3d12_xs/interfaces/ID3D12GraphicsCommandList4/id3d12graphicscommandlist4)


## Related topics

- [CopyRaytracingAccelerationStructure (XBOX Series consoles)](/reference/graphics/d3d12/interfaces/id3d12graphicscommandlist4/methods/id3d12graphicscommandlist4_copyraytracingaccelerationstructure_public.md)
- [CopyRaytracingAccelerationStructure (consolas XBOX Series)](/es/reference/graphics/d3d12/interfaces/id3d12graphicscommandlist4/methods/id3d12graphicscommandlist4_copyraytracingaccelerationstructure_public.md)
- [CopyRaytracingAccelerationStructure (XBOX Series 콘솔)](/ko/reference/graphics/d3d12/interfaces/id3d12graphicscommandlist4/methods/id3d12graphicscommandlist4_copyraytracingaccelerationstructure_public.md)
- [CopyRaytracingAccelerationStructure (XBOX Series 主机)](/zh-CN/reference/graphics/d3d12/interfaces/id3d12graphicscommandlist4/methods/id3d12graphicscommandlist4_copyraytracingaccelerationstructure_public.md)
- [CopyRaytracingAccelerationStructure (XBOX Series 本体)](/ja-jp/reference/graphics/d3d12/interfaces/id3d12graphicscommandlist4/methods/id3d12graphicscommandlist4_copyraytracingaccelerationstructure_public.md)