Skip to main content
指示重新使用与命令分配器关联的内存。

语法

参数

返回值

类型:HRESULT 如果有活动的记录命令列表引用该命令分配器,则此方法返回 E_FAIL。在这种情况下,调试层也将发出错误。 其他可能的返回值请参阅 Direct3D 12 返回代码

备注

应用程序调用 Reset 以重新使用与命令分配器关联的内存。通过此 Reset 调用,运行时和驱动程序判断图形处理单元 (GPU) 不再执行任何使用该命令分配器记录了命令的命令列表。 ID3D12GraphicsCommandList::Reset 不同,不建议在命令列表仍在执行时对命令分配器调用 Reset 如果调试层无法证明没有对使用该分配器记录了命令的命令列表的挂起 GPU 引用,将发出警告。 如果多个线程并发地对同一个分配器对象调用 Reset,则调试层将发出错误。

示例

D3D12HelloTriangle 示例按如下方式使用 ID3D12CommandAllocator::Reset
请参阅 D3D12 参考中的示例代码

要求

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

另请参阅

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