Skip to main content
等同於 GetRaytracingAccelerationStructurePrebuildInfo，差別在於它會考慮使用 BuildRaytracingAccelerationStructureBatched2X 建置時套用至加速結構的額外選項。
當 pExtraOptions 不是 null 時，必須使用此函式，而不是 GetRaytracingAccelerationStructurePrebuildInfo。

​
語法

​
參數

pInputs   _In_
類型：D3D12_BUILD_RAYTRACING_ACCELERATION_STRUCTURE_INPUTS* 加速結構建置的描述。此結構與各種 BuildRaytracingAccelerationStructure* 變體共用。如需詳細資訊，請參閱 D3D12_BUILD_RAYTRACING_ACCELERATION_STRUCTURE_INPUTS。 實作可以查看此結構及巢狀結構中的所有 CPU 參數。除了檢查指標是否為 NULL (例如 D3D12_RAYTRACING_GEOMETRY_TRIANGLES_DESC 中選擇性的轉換) 而不取值之外，它不能檢查或取值任何 GPU 虛擬位址。換句話說，加速結構的資源需求計算不取決於實際的幾何資料 (例如頂點位置)，而只能取決於整體屬性，例如三角形數目、執行個體數目等。 pExtraOptions   _In_
類型：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 中的範例 1。 pInfo   _Out_
類型：D3D12_RAYTRACING_ACCELERATION_STRUCTURE_PREBUILD_INFO* 查詢的結果。

​
傳回值

類型：void

​
備註

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

​
需求

標頭： d3d12_xs.h
程式庫： d3d12_xs.lib
支援的平台： XBOX Series 主機

​
另請參閱

ID3D12Device8
Last modified on October 6, 2026