Skip to main content
指定された変換を適用しながら、ソース アクセラレーション構造を宛先メモリにコピーします。

構文

パラメーター

DestAccelerationStructureData [in]
型: D3D12_GPU_VIRTUAL_ADDRESS
宛先メモリ。指定した Mode に必要な場合、必要なサイズは事前に EmitRaytracingAccelerationStructurePostbuildInfo を呼び出すことで判明します。 宛先の先頭アドレスは、指定した Mode にかかわらず、D3D12_RAYTRACING_ACCELERATION_STRUCTURE_BYTE_ALIGNMENT として定義される 256 バイトにアラインされている必要があります。 宛先のメモリ範囲はソースと重なってはいけません。重なっている場合、結果は未定義になります。 指されているメモリが取るべきリソース状態は、Mode パラメーターによって決まります。詳細については、D3D12_RAYTRACING_ACCELERATION_STRUCTURE_COPY_MODE を参照してください。 SourceAccelerationStructureData [in]
型: D3D12_GPU_VIRTUAL_ADDRESS
指定した Mode に基づいてコピー/変換されるアクセラレーション構造または他の種類のデータのアドレス。このデータは変更されず、引き続き使用可能です。この操作では、SourceAccelerationStructureData が指すデータのみがコピーされ、そのソース データが指す可能性のあるアクセラレーション構造などの他のデータはコピーされません。たとえば、トップレベル アクセラレーション構造の場合、それが指すボトムレベル アクセラレーション構造は、この操作でコピーされません。 ソース メモリは、指定した Mode にかかわらず、D3D12_RAYTRACING_ACCELERATION_STRUCTURE_BYTE_ALIGNMENT として定義される 256 バイトにアラインされている必要があります。 指されているメモリが取るべきリソース状態は、Mode パラメーターによって決まります。詳細については、D3D12_RAYTRACING_ACCELERATION_STRUCTURE_COPY_MODE を参照してください。 Mode [in]
型: D3D12_RAYTRACING_ACCELERATION_STRUCTURE_COPY_MODE
実行するコピー操作の種類。詳細については、D3D12_RAYTRACING_ACCELERATION_STRUCTURE_COPY_MODE を参照してください。

戻り値

型: void なし。

解説

レイトレーシング アクセラレーション構造には内部ポインターが含まれることがあり、デバイス依存の不透明なレイアウトを持つ場合があるため、それらのコピーや操作にはドライバーが要求された操作を処理できるように専用の API が必要です。 このメソッドは、グラフィックスまたはコンピュートのコマンド リストから呼び出すことができますが、バンドルからは呼び出すことができません。

要件

ヘッダー: d3d12_xs.h
ライブラリ: d3d12_xs.lib
サポートされているプラットフォーム: XBOX Series 本体

関連項目

ID3D12GraphicsCommandList4
最終更新日 2026年8月24日