> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# D3D12_DRED_ALLOCATION_NODE

> 作为链表中的节点,描述有关设备已移除的扩展数据 (DRED) 所跟踪的分配的数据。

作为链表中的节点,描述有关设备已移除的扩展数据 (DRED) 所跟踪的分配的数据。此数据包括 GPU VA 分配范围,以及关联的运行时对象调试名称和类型。每个 **D3D12\_DRED\_ALLOCATION\_NODE** 对象通过其 `pNext` 成员单向链接到下一个;链表中的最后一个节点除外,其 `pNext` 设置为 `nullptr`。链表结构是必要的,因为运行时对象可以与其他对象共享分配范围。

如果设备移除是由 GPU 页面错误引起—并且启用了 DRED 页面错误报告—那么 DRED 会构建一个 D3D12\_DRED\_ALLOCATION\_NODE 结构列表,其中包括活动运行时对象和最近释放的运行时对象的所有匹配分配节点。

## 语法

```cpp theme={null}
typedef struct D3D12_DRED_ALLOCATION_NODE
{
    const char  ObjectNameA;
    const wchar_t  ObjectNameW;
    D3D12_DRED_ALLOCATION_TYPE AllocationType;
    const struct D3D12_DRED_ALLOCATION_NODE  pNext;
} D3D12_DRED_ALLOCATION_NODE
```

### 成员

*ObjectNameA*\
类型:const char \*

指向所分配运行时对象的 ANSI 调试名称的指针。

*ObjectNameW*\
类型:const wchar\_t \*

指向所分配运行时对象的宽字符调试名称的指针。

*AllocationType*\
类型:D3D12\_DRED\_ALLOCATION\_TYPE

一个 [D3D12\_DRED\_ALLOCATION\_TYPE](/reference/graphics/d3d12/enums/d3d12_dred_allocation_type_public) 值,表示运行时对象的分配类型。

*pNext*\
类型:const struct D3D12\_DRED\_ALLOCATION\_NODE \*

指向常量 **D3D12\_DRED\_ALLOCATION\_NODE** 的指针,表示列表中的下一个分配节点;如果这是最后一个节点,则为 `nullptr`。

## 要求

**头文件:** d3d12\_xs.h 或 d3d12\_x.h\
**库:** d3d12\_xs.lib 或 d3d12\_x.lib\
**支持的平台**:XBOX Series 主机和 XBOX One 系列

## 另请参阅

* [核心结构](https://learn.microsoft.com/en-us/windows/desktop/direct3d12/direct3d-12-structures)
* [使用 DRED 诊断 GPU 故障](https://learn.microsoft.com/en-us/windows/desktop/direct3d12/use-dred)


## Related topics

- [D3D12_DRED_PAGE_FAULT_OUTPUT](/zh-CN/reference/graphics/d3d12/structs/d3d12_dred_page_fault_output_public.md)
- [D3D12_DRED_ALLOCATION_TYPE](/zh-CN/reference/graphics/d3d12/enums/d3d12_dred_allocation_type_public.md)
- [D3D12_DRED_AUTO_BREADCRUMBS_OUTPUT](/zh-CN/reference/graphics/d3d12/structs/d3d12_dred_auto_breadcrumbs_output_public.md)
- [D3D12_AUTO_BREADCRUMB_NODE](/zh-CN/reference/graphics/d3d12/structs/d3d12_auto_breadcrumb_node_public.md)
- [D3D12_DRED_ENABLEMENT](/zh-CN/reference/graphics/d3d12/enums/d3d12_dred_enablement_public.md)