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

# GetRaytracingAccelerationStructurePrebuildInfoX

> 向驅動程式查詢建置加速結構所需的資源需求。

等同於 [GetRaytracingAccelerationStructurePrebuildInfo](https://learn.microsoft.com/en-us/windows/win32/api/d3d12/nf-d3d12-id3d12device5-getraytracingaccelerationstructureprebuildinfo)，差別在於它會考慮使用 [BuildRaytracingAccelerationStructureBatched2X](/zh-TW/reference/graphics/d3d12_xs/interfaces/ID3D12GraphicsCommandList6/methods/id3d12graphicscommandlist6_buildraytracingaccelerationstructurebatched2x) 建置時套用至加速結構的額外選項。

<Note>
  當 *pExtraOptions* 不是 null 時，*必須*使用此函式，而不是 [GetRaytracingAccelerationStructurePrebuildInfo](https://learn.microsoft.com/en-us/windows/win32/api/d3d12/nf-d3d12-id3d12device5-getraytracingaccelerationstructureprebuildinfo)。
</Note>

## 語法

```cpp theme={null}
void GetRaytracingAccelerationStructurePrebuildInfoX(  
         const D3D12_BUILD_RAYTRACING_ACCELERATION_STRUCTURE_INPUTS* pInputs,  
         const D3D12XBOX_XDXR_STREAM_DESC* pExtraOptions,  
         D3D12_RAYTRACING_ACCELERATION_STRUCTURE_PREBUILD_INFO* pInfo  
)  
```

### 參數

*pInputs*   \_In\_\
類型：D3D12\_BUILD\_RAYTRACING\_ACCELERATION\_STRUCTURE\_INPUTS\*

加速結構建置的描述。此結構與各種 `BuildRaytracingAccelerationStructure*` 變體共用。如需詳細資訊，請參閱 [D3D12\_BUILD\_RAYTRACING\_ACCELERATION\_STRUCTURE\_INPUTS](https://learn.microsoft.com/en-us/windows/win32/api/d3d12/ns-d3d12-d3d12_build_raytracing_acceleration_structure_inputs)。

實作可以查看此結構及巢狀結構中的所有 CPU 參數。除了檢查指標是否為 NULL (例如 `D3D12_RAYTRACING_GEOMETRY_TRIANGLES_DESC` 中選擇性的轉換) 而不取值之外，它不能檢查或取值任何 GPU 虛擬位址。換句話說，加速結構的資源需求計算不取決於實際的幾何資料 (例如頂點位置)，而只能取決於整體屬性，例如三角形數目、執行個體數目等。

*pExtraOptions*   \_In\_\
類型：[D3D12XBOX\_XDXR\_STREAM\_DESC\*](/zh-TW/reference/graphics/d3d12_xs/structs/d3d12xbox_xdxr_stream_desc)

指定資料 Blob 的大小和位置，該 Blob 可重新解譯為下列一或多個結構：

* `D3D12XBOX_BUILD_RAYTRACING_ACCELERATION_STRUCTURE_PARAMS1`
* `D3D12XBOX_BUILD_RAYTRACING_ACCELERATION_STRUCTURE_PARAMS2`
* `D3D12XBOX_BUILD_RAYTRACING_ACCELERATION_STRUCTURE_PARAMS3`

這些結構會向加速結構建置流程公開 XBOX 功能延伸和較低層級的控制項。

如需建立此 Blob、查詢預先建置大小，以及使用額外選項執行 BVH 建置的完整範例，請參閱 [BuildRaytracingAccelerationStructureBatched2X](/zh-TW/reference/graphics/d3d12_xs/interfaces/ID3D12GraphicsCommandList6/methods/id3d12graphicscommandlist6_buildraytracingaccelerationstructurebatched2x) 中的範例 1。

*pInfo*   \_Out\_\
類型：D3D12\_RAYTRACING\_ACCELERATION\_STRUCTURE\_PREBUILD\_INFO\*

查詢的結果。

### 傳回值

類型：void

## 備註

如需此函式用途的詳細資訊，請參閱 `GetRaytracingAccelerationStructurePrebuildInfo` 的描述。此變體為 XBOX 專用，在為 *pExtraOptions* 提供值時，應搭配 `BuildRaytracingAccelerationStructureBatched2X` 使用。

## 需求

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

## 另請參閱

[ID3D12Device8](/zh-TW/reference/graphics/d3d12_xs/interfaces/ID3D12Device8/id3d12device8)


## Related topics

- [GetRaytracingAccelerationStructurePrebuildInfo](/reference/graphics/d3d12/interfaces/id3d12device5/methods/id3d12device5_getraytracingaccelerationstructureprebuildinfo_public.md)
- [D3D12_RAYTRACING_ACCELERATION_STRUCTURE_PREBUILD_INFO](/reference/graphics/d3d12/structs/d3d12_raytracing_acceleration_structure_prebuild_info_public.md)