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

# GetRaytracingAccelerationStructurePrebuildInfo

> アクセラレーション構造の構築に必要なリソース要件をドライバーに照会します。

アクセラレーション構造の構築に必要なリソース要件をドライバーに照会します。

## 構文

```cpp theme={null}
void GetRaytracingAccelerationStructurePrebuildInfo(
    const D3D12_BUILD_RAYTRACING_ACCELERATION_STRUCTURE_INPUTS  pDesc,
    D3D12_RAYTRACING_ACCELERATION_STRUCTURE_PREBUILD_INFO  pInfo
)
```

### パラメーター

*pDesc \[in]*\
型: const D3D12\_BUILD\_RAYTRACING\_ACCELERATION\_STRUCTURE\_INPUTS \*

アクセラレーション構造の構築の記述。この構造体は [BuildRaytracingAccelerationStructure](/reference/graphics/d3d12/interfaces/id3d12graphicscommandlist4/methods/id3d12graphicscommandlist4_buildraytracingaccelerationstructure_public) と共有されます。詳細については、[D3D12\_BUILD\_RAYTRACING\_ACCELERATION\_STRUCTURE\_INPUTS](/reference/graphics/d3d12/structs/d3d12_build_raytracing_acceleration_structure_inputs_public) を参照してください。

実装は、この構造体およびネストされた構造体内のすべての CPU パラメーターを参照することが許可されます。実装は、ポインターが NULL かどうかを確認する以外に GPU 仮想アドレスの検査や逆参照を行うことはできません (たとえば [D3D12\_RAYTRACING\_GEOMETRY\_TRIANGLES\_DESC](/reference/graphics/d3d12/structs/d3d12_raytracing_geometry_triangles_desc_public) 内のオプションの変換を、逆参照せずに確認するなど)。言い換えれば、アクセラレーション構造のリソース要件の計算は実際のジオメトリ データ (頂点位置など) に依存せず、三角形の数、インスタンスの数などの全体的なプロパティにのみ依存します。

*pInfo \[out]*\
型: D3D12\_RAYTRACING\_ACCELERATION\_STRUCTURE\_PREBUILD\_INFO \*

クエリの結果。

### 戻り値

型: void

なし。

## 解説

入力アクセラレーション構造の記述は、[BuildRaytracingAccelerationStructure](/reference/graphics/d3d12/interfaces/id3d12graphicscommandlist4/methods/id3d12graphicscommandlist4_buildraytracingaccelerationstructure_public) に渡すものと同じです。この関数の結果により、アプリケーションは同じジオメトリを持つ **BuildRaytracingAccelerationStructure** に対して、正しい量の出力ストレージとスクラッチ ストレージを提供できます。

構築は、**GetAccelerationStructurePrebuildInfo** に渡された構成と全体的に同じで、ジオメトリ/インスタンスの数、または任意のジオメトリ内の頂点/インデックス/AABB の数が同じかそれ以下の場合にも実行できます。この場合、**GetRaytracingAccelerationStructurePrebuildInfo** に渡された元のサイズで報告されたストレージ要件は有効になります。構築は実際にはより少ないスペースを消費する可能性がありますが、より多くのスペースを消費することはありません。これは、アクセラレーション構造用に保守的に大きなストレージを割り当てておくことに問題がないアプリのシナリオで便利です。

このメソッドがコマンド リストではなくデバイス インターフェイス上にあるのは、ドライバーが呼び出しの CPU から見える部分のみを参照して、実際の頂点データ、インデックス データなどを含む GPU メモリへのポインターを逆参照することなくアクセラレーション構造の構築のリソース要件を計算できる必要があるという前提に基づいています。

## 要件

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

## 関連項目

[ID3D12Device5](/reference/graphics/d3d12/interfaces/id3d12device5/id3d12device5_public)


## Related topics

- [D3D12_RAYTRACING_ACCELERATION_STRUCTURE_PREBUILD_INFO](/ja-jp/reference/graphics/d3d12/structs/d3d12_raytracing_acceleration_structure_prebuild_info_public.md)
- [D3D12_BUILD_RAYTRACING_ACCELERATION_STRUCTURE_INPUTS](/ja-jp/reference/graphics/d3d12/structs/d3d12_build_raytracing_acceleration_structure_inputs_public.md)
- [D3D12_BUILD_RAYTRACING_ACCELERATION_STRUCTURE_DESC](/ja-jp/reference/graphics/d3d12/structs/d3d12_build_raytracing_acceleration_structure_desc_public.md)
- [D3D12_RAYTRACING_ACCELERATION_STRUCTURE_POSTBUILD_INFO_CURRENT_SIZE_DESC (XBOX Series 本体)](/ja-jp/reference/graphics/d3d12/structs/d3d12_raytracing_acceleration_structure_postbuild_info_current_size_desc_public.md)
- [D3D12_RAYTRACING_ACCELERATION_STRUCTURE_POSTBUILD_INFO_COMPACTED_SIZE_DESC (XBOX Series 本体)](/ja-jp/reference/graphics/d3d12/structs/d3d12_raytracing_acceleration_structure_postbuild_info_compacted_size_desc_public.md)