Skip to main content
执行捆绑包。

语法

参数

pCommandList [in]
类型:ID3D12GraphicsCommandList *
指定确定要执行的捆绑包的 ID3D12GraphicsCommandList

返回值

类型:void 无。

备注

捆绑包从其上调用 ExecuteBundle 的父命令列表继承所有状态,除了管道状态对象和图元拓扑。捆绑包中设置的所有状态都将影响父命令列表的状态。请注意,ExecuteBundle 不是谓词操作。

运行时验证

运行时将验证”被调用者”是捆绑包,“调用者”是直接命令列表。运行时还将验证捆绑包已关闭。如果违反了约定,运行时将默默丢弃该调用。 验证失败将导致 Close 返回 E_INVALIDARG。

调试层

在与运行时失败相同的情况下,调试层将发出警告。 如果在调用 ExecuteCommandList 时设置了谓词,调试层将发出警告。 此外,如果调试层检测到命令列表引用的任何资源已被销毁,则会发出错误。
调试层还将验证与捆绑包关联的命令分配器自从对命令列表调用 Close 以来尚未重置。此验证发生在 ExecuteBundle 时以及在命令队列上执行父命令列表时。

示例

D3D12Bundles 示例按以下方式使用 ID3D12GraphicsCommandList::ExecuteBundle
请参阅 Direct3D 12 参考中的示例代码

要求

头文件: d3d12_xs.h 或 d3d12_x.h
库: d3d12_xs.lib 或 d3d12_x.lib
支持的平台:XBOX Series 主机和 XBOX One 系列

另请参阅

ID3D12GraphicsCommandList
最后修改于 2026年8月24日