> ## 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 参数。它不能检查/解引用任何 GPU 虚拟地址，只能检查指针是否为 NULL，例如 [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](/zh-CN/reference/graphics/d3d12/structs/d3d12_raytracing_acceleration_structure_prebuild_info_public.md)
- [D3D12_BUILD_RAYTRACING_ACCELERATION_STRUCTURE_INPUTS](/zh-CN/reference/graphics/d3d12/structs/d3d12_build_raytracing_acceleration_structure_inputs_public.md)
- [D3D12_BUILD_RAYTRACING_ACCELERATION_STRUCTURE_DESC](/zh-CN/reference/graphics/d3d12/structs/d3d12_build_raytracing_acceleration_structure_desc_public.md)
- [D3D12_RAYTRACING_ACCELERATION_STRUCTURE_POSTBUILD_INFO_CURRENT_SIZE_DESC (XBOX Series consoles)](/zh-CN/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 consoles)](/zh-CN/reference/graphics/d3d12/structs/d3d12_raytracing_acceleration_structure_postbuild_info_compacted_size_desc_public.md)