Skip to main content
以链表节点的形式表示设备移除扩展数据 (DRED) 自动痕迹数据。每个 D3D12_AUTO_BREADCRUMB_NODE 对象通过其 pNext 成员单向链接到下一个对象;列表中的最后一个节点例外,其 pNext 被设置为 nullptr Direct3D 12 运行时为每个图形命令列表创建一个此类对象,并在与该列表关联的命令分配器中对其进行跟踪。命令列表被执行时,将设置命令队列信息。检测到设备移除后,Direct3D 12 运行时会将任何仍在处理中的 GPU 工作对应的自动痕迹节点链接在一起。

语法

成员

pCommandListDebugNameA
类型:const char *
指向未处理命令列表(如果有)的 ANSI 调试名称的指针。 pCommandListDebugNameW
类型:const wchar_t *
指向未处理命令列表(如果有)的宽字符调试名称的指针。 pCommandQueueDebugNameA
类型:const char *
指向未处理命令队列(如果有)的 ANSI 调试名称的指针。 pCommandQueueDebugNameW
类型:const wchar_t *
指向未处理命令队列(如果有)的宽字符调试名称的指针。 pCommandList
类型:ID3D12GraphicsCommandList *
指向 ID3D12GraphicsCommandList 接口的指针,该接口表示执行时未处理的命令列表。 pCommandQueue
类型:ID3D12CommandQueue *
指向 ID3D12CommandQueue 接口的指针,该接口表示未处理的命令队列。 BreadcrumbCount
类型:UINT32
一个 UINT32,包含 pCommandHistory 所指向数组中 D3D12_AUTO_BREADCRUMB_OP 值的数量。 pLastBreadcrumbValue
类型:UINT32 *
指向常量 UINT32 的指针,该值包含 GPU 在执行相关命令列表时完成的最后一个渲染/计算操作在 pCommandHistory 所指向数组中的索引。 pCommandHistory
类型:D3D12_AUTO_BREADCRUMB_OP *
指向常量 D3D12_AUTO_BREADCRUMB_OP 值数组的指针,该数组表示记录到相关命令列表中的所有渲染/计算操作。 pNext
类型:struct D3D12_AUTO_BREADCRUMB_NODE *
指向常量 D3D12_AUTO_BREADCRUMB_NODE 的指针,表示列表中的下一个自动痕迹节点;如果这是最后一个节点,则为 nullptr

要求

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

另请参阅

最后修改于 2026年8月24日