> ## 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](/zh-TW/reference/graphics/d3d12/interfaces/id3d12graphicscommandlist4/methods/id3d12graphicscommandlist4_buildraytracingaccelerationstructure_public) 共用。如需詳細資訊，請參閱 [D3D12\_BUILD\_RAYTRACING\_ACCELERATION\_STRUCTURE\_INPUTS](/zh-TW/reference/graphics/d3d12/structs/d3d12_build_raytracing_acceleration_structure_inputs_public)。

實作可以查看此結構及巢狀結構中的所有 CPU 參數。但除了檢查指標是否為 NULL 之外 (例如 [D3D12\_RAYTRACING\_GEOMETRY\_TRIANGLES\_DESC](/zh-TW/reference/graphics/d3d12/structs/d3d12_raytracing_geometry_triangles_desc_public) 中的選擇性轉換，且不取值)，不得檢查或取值任何 GPU 虛擬位址。換句話說，加速結構資源需求的計算不取決於實際的幾何資料 (例如頂點位置)，而只能取決於整體屬性，例如三角形數目、執行個體數目等。

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

查詢的結果。

### 傳回值

類型：void

無。

## 備註

輸入的加速結構描述與傳入 [BuildRaytracingAccelerationStructure](/zh-TW/reference/graphics/d3d12/interfaces/id3d12graphicscommandlist4/methods/id3d12graphicscommandlist4_buildraytracingaccelerationstructure_public) 的內容相同。此函式的結果可讓應用程式在相同幾何的情況下，為 **BuildRaytracingAccelerationStructure** 提供正確數量的輸出儲存空間與暫存儲存空間。

也可以使用與傳遞給 **GetAccelerationStructurePrebuildInfo** 整體相同的設定進行建置，只是幾何/執行個體數目，或任何指定幾何中的頂點/索引/AABB 數目相等或更少。在此情況下，以傳遞給 **GetRaytracingAccelerationStructurePrebuildInfo** 的原始大小所回報的儲存需求仍然有效；建置實際上可能會使用較少的空間，但不會更多。這適用於可以為加速結構保守地配置較大儲存空間的應用程式情境。

此方法位於裝置介面而非命令清單上，其假設是驅動程式必須僅查看呼叫中 CPU 可見的部分，就能計算加速結構建置的資源需求，而不需對包含實際頂點資料、索引資料等的 GPU 記憶體取值任何指標。

## 需求

**標頭:** d3d12\_xs.h\
**程式庫:** d3d12\_xs.lib\
**支援的平台**: XBOX Series 主機

## 另請參閱

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


## Related topics

- [D3D12_RAYTRACING_ACCELERATION_STRUCTURE_PREBUILD_INFO](/zh-TW/reference/graphics/d3d12/structs/d3d12_raytracing_acceleration_structure_prebuild_info_public.md)
- [D3D12_BUILD_RAYTRACING_ACCELERATION_STRUCTURE_INPUTS](/zh-TW/reference/graphics/d3d12/structs/d3d12_build_raytracing_acceleration_structure_inputs_public.md)
- [D3D12_BUILD_RAYTRACING_ACCELERATION_STRUCTURE_DESC](/zh-TW/reference/graphics/d3d12/structs/d3d12_build_raytracing_acceleration_structure_desc_public.md)
- [D3D12_RAYTRACING_ACCELERATION_STRUCTURE_POSTBUILD_INFO_CURRENT_SIZE_DESC (XBOX Series 主機)](/zh-TW/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 主機)](/zh-TW/reference/graphics/d3d12/structs/d3d12_raytracing_acceleration_structure_postbuild_info_compacted_size_desc_public.md)