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

# D3D12_BUILD_RAYTRACING_ACCELERATION_STRUCTURE_DESC

> レイトレーシング アクセラレーション構造を記述します。ビルドするアクセラレーション構造を記述するために、この構造体を ID3D12GraphicsCommandList4::BuildRaytracingAccelerationStructure に渡します。

レイトレーシング アクセラレーション構造を記述します。ビルドするアクセラレーション構造を記述するために、この構造体を [ID3D12GraphicsCommandList4::BuildRaytracingAccelerationStructure](/reference/graphics/d3d12/interfaces/id3d12graphicscommandlist4/methods/id3d12graphicscommandlist4_buildraytracingaccelerationstructure_public) に渡します。

## 構文

```cpp theme={null}
typedef struct D3D12_BUILD_RAYTRACING_ACCELERATION_STRUCTURE_DESC
{
    D3D12_GPU_VIRTUAL_ADDRESS DestAccelerationStructureData;
    D3D12_BUILD_RAYTRACING_ACCELERATION_STRUCTURE_INPUTS Inputs;
    D3D12_GPU_VIRTUAL_ADDRESS SourceAccelerationStructureData;
    D3D12_GPU_VIRTUAL_ADDRESS ScratchAccelerationStructureData;
} D3D12_BUILD_RAYTRACING_ACCELERATION_STRUCTURE_DESC
```

### メンバー

*DestAccelerationStructureData*\
型: D3D12\_GPU\_VIRTUAL\_ADDRESS

結果として得られるアクセラレーション構造を格納する場所。[ID3D12Device5::GetRaytracingAccelerationStructurePrebuildInfo](/reference/graphics/d3d12/interfaces/id3d12device5/methods/id3d12device5_getraytracingaccelerationstructureprebuildinfo_public) は、指定されたアクセラレーション構造ビルド パラメーターのセットに対して、ここに結果を格納するために必要なメモリの量を報告します。

このアドレスは 256 バイト境界に揃える必要があります。これは [D3D12\_RAYTRACING\_ACCELERATION\_STRUCTURE\_BYTE\_ALIGNMENT](https://learn.microsoft.com/en-us/windows/desktop/direct3d12/constants) として定義されています。

<Info>
  メモリは状態 [**D3D12\_RESOURCE\_STATE\_RAYTRACING\_ACCELERATION\_STRUCTURE**](/reference/graphics/d3d12_x/enums/d3d12_resource_states) にある必要があります。
</Info>

*Inputs*\
型: D3D12\_BUILD\_RAYTRACING\_ACCELERATION\_STRUCTURE\_INPUTS

アクセラレーション構造ビルドの入力データの記述。このデータは、**GetRaytracingAccelerationStructurePrebuildInfo** でも使用されるため、別の構造体に格納されます。

*SourceAccelerationStructureData*\
型: D3D12\_GPU\_VIRTUAL\_ADDRESS

Flags パラメーターで [D3D12\_RAYTRACING\_ACCELERATION\_STRUCTURE\_BUILD\_FLAG\_PERFORM\_UPDATE](/reference/graphics/d3d12/enums/d3d12_raytracing_acceleration_structure_build_flags_public) を設定してアクセラレーション構造の更新 (増分ビルド) が要求される場合の、既存のアクセラレーション構造のアドレス。それ以外の場合、このアドレスは NULL である必要があります。

このアドレスが <i>DestAccelerationStructureData</i> と同じ場合、更新は in-place で実行されます。ソースと宛先のメモリのその他の重複は無効であり、未定義の動作を引き起こします。

このアドレスは 256 バイト境界に揃える必要があります (これは [D3D12\_RAYTRACING\_ACCELERATION\_STRUCTURE\_BYTE\_ALIGNMENT](https://learn.microsoft.com/en-us/windows/desktop/direct3d12/constants) として定義されています)。ここに渡される既存のアクセラレーション構造は、そのようなアラインメントで配置されている必要があるため、これは自動的に満たされているはずです。

<Info>
  メモリは状態 [**D3D12\_RESOURCE\_STATE\_RAYTRACING\_ACCELERATION\_STRUCTURE**](/reference/graphics/d3d12_x/enums/d3d12_resource_states) にある必要があります。
</Info>

#### ScratchAccelerationStructureData

ビルドが一時データを格納する場所。**GetRaytracingAccelerationStructurePrebuildInfo** は、指定されたアクセラレーション構造ビルド パラメーターのセットに対して実装が必要とするスクラッチ メモリの量を報告します。

<Info>
  メモリは状態 [**D3D12\_RESOURCE\_STATE\_UNORDERED\_ACCESS**](/reference/graphics/d3d12_x/enums/d3d12_resource_states) にある必要があります。
</Info>

*ScratchAccelerationStructureData*\
型: D3D12\_GPU\_VIRTUAL\_ADDRESS

## 要件

**ヘッダー:** d3d12\_xs.h\
**ライブラリ:** d3d12\_xs.lib\
**サポートされるプラットフォーム**: XBOX Series 本体


## Related topics

- [BuildRaytracingAccelerationStructure (XBOX Series 本体)](/ja-jp/reference/graphics/d3d12/interfaces/id3d12graphicscommandlist4/methods/id3d12graphicscommandlist4_buildraytracingaccelerationstructure_public.md)
- [D3D12_BUILD_RAYTRACING_ACCELERATION_STRUCTURE_INPUTS](/ja-jp/reference/graphics/d3d12/structs/d3d12_build_raytracing_acceleration_structure_inputs_public.md)
- [D3D12_RAYTRACING_ACCELERATION_STRUCTURE_POSTBUILD_INFO_DESC](/ja-jp/reference/graphics/d3d12/structs/d3d12_raytracing_acceleration_structure_postbuild_info_desc_public.md)
- [D3D12_BUILD_RAYTRACING_ACCELERATION_STRUCTURE_TOOLS_VISUALIZATION_HEADER (XBOX Series consoles)](/ja-jp/reference/graphics/d3d12/structs/d3d12_build_raytracing_acceleration_structure_tools_visualization_header_public.md)
- [D3D12_RAYTRACING_ACCELERATION_STRUCTURE_POSTBUILD_INFO_SERIALIZATION_DESC (XBOX Series 本体)](/ja-jp/reference/graphics/d3d12/structs/d3d12_raytracing_acceleration_structure_postbuild_info_serialization_desc_public.md)