> ## 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](/zh-TW/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-TW/reference/graphics/d3d12/structs/d3d12_dred_page_fault_output_public.md)
- [D3D12_DRED_ALLOCATION_TYPE](/zh-TW/reference/graphics/d3d12/enums/d3d12_dred_allocation_type_public.md)
- [D3D12_DRED_AUTO_BREADCRUMBS_OUTPUT](/zh-TW/reference/graphics/d3d12/structs/d3d12_dred_auto_breadcrumbs_output_public.md)
- [D3D12_AUTO_BREADCRUMB_NODE](/zh-TW/reference/graphics/d3d12/structs/d3d12_auto_breadcrumb_node_public.md)
- [D3D12_DRED_VERSION](/zh-TW/reference/graphics/d3d12/enums/d3d12_dred_version_public.md)