> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# D3D12_RAYTRACING_ACCELERATION_STRUCTURE_PREBUILD_INFO

> 表示有关光线追踪加速结构的预构建信息。通过调用来获取此结构的实例。

表示有关光线追踪加速结构的预构建信息。通过调用 [GetRaytracingAccelerationStructurePrebuildInfo](https://docs.xbox.com/zh-CN/reference/graphics/d3d12/interfaces/id3d12device5/methods/id3d12device5_getraytracingaccelerationstructureprebuildinfo_public.md) 获取此结构的实例。

## 语法

```cpp theme={null}
typedef struct D3D12_RAYTRACING_ACCELERATION_STRUCTURE_PREBUILD_INFO
{
    UINT64 ResultDataMaxSizeInBytes;
    UINT64 ScratchDataSizeInBytes;
    UINT64 UpdateScratchDataSizeInBytes;
} D3D12_RAYTRACING_ACCELERATION_STRUCTURE_PREBUILD_INFO
```

### 成员

*ResultDataMaxSizeInBytes*\
类型：UINT64

保存基于指定输入的加速结构构建结果所需的大小。

*ScratchDataSizeInBytes*\
类型：UINT64

基于指定输入的加速结构构建期间在 GPU 上所需的暂存存储。

#### UpdateScratchDataSizeInBytes

基于指定输入的加速结构更新期间在 GPU 上所需的暂存存储。这只需为原始加速结构构建调用，并定义除初始构建外每次加速结构更新的暂存存储要求。

如果在调用 [GetRaytracingAccelerationStructurePrebuildInfo](https://docs.xbox.com/zh-CN/reference/graphics/d3d12/interfaces/id3d12device5/methods/id3d12device5_getraytracingaccelerationstructureprebuildinfo_public.md) 时未指定 [D3D12\_RAYTRACING\_ACCELERATION\_STRUCTURE\_BUILD\_FLAG\_ALLOW\_UPDATE](https://docs.xbox.com/zh-CN/reference/graphics/d3d12/enums/d3d12_raytracing_acceleration_structure_build_flags_public.md) 标志，则此字段的返回值为 0。

*UpdateScratchDataSizeInBytes*\
类型：UINT64

## 要求

**头文件：** d3d12\_xs.h\
**库：** d3d12\_xs.lib\
**支持的平台**：XBOX Series 主机


## Related topics

- [GetRaytracingAccelerationStructurePrebuildInfo](https://docs.xbox.com/zh-CN/reference/graphics/d3d12/interfaces/id3d12device5/methods/id3d12device5_getraytracingaccelerationstructureprebuildinfo_public.md)
- [D3D12_BUILD_RAYTRACING_ACCELERATION_STRUCTURE_INPUTS](https://docs.xbox.com/zh-CN/reference/graphics/d3d12/structs/d3d12_build_raytracing_acceleration_structure_inputs_public.md)
- [D3D12_BUILD_RAYTRACING_ACCELERATION_STRUCTURE_DESC](https://docs.xbox.com/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)](https://docs.xbox.com/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)](https://docs.xbox.com/zh-CN/reference/graphics/d3d12/structs/d3d12_raytracing_acceleration_structure_postbuild_info_compacted_size_desc_public.md)