> ## 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_AUTO_BREADCRUMB_NODE

> 장치 제거 확장 데이터(DRED) 자동 브레드크럼 데이터를 연결 목록의 노드로 나타냅니다.

장치 제거 확장 데이터(DRED) 자동 브레드크럼 데이터를 연결 목록의 노드로 나타냅니다. 각 **D3D12\_AUTO\_BREADCRUMB\_NODE** 객체는 `pNext` 멤버를 통해 다음 노드에 단일 연결됩니다. 목록의 마지막 노드는 예외로, `pNext`가 `nullptr`로 설정되어 있습니다.

Direct3D 12 런타임은 각 그래픽 명령 목록에 대해 이러한 노드를 하나씩 생성하고, 해당 목록과 연결된 명령 할당자에서 이를 추적합니다. 명령 목록이 실행되면 명령 큐 정보가 설정됩니다. 장치 제거가 감지된 후, Direct3D 12 런타임은 아직 완료되지 않은 모든 GPU 작업에 대한 자동 브레드크럼 노드를 함께 연결합니다.

## 구문

```cpp theme={null}
typedef struct D3D12_AUTO_BREADCRUMB_NODE
{
    const char  pCommandListDebugNameA;
    const wchar_t  pCommandListDebugNameW;
    const char  pCommandQueueDebugNameA;
    const wchar_t  pCommandQueueDebugNameW;
    ID3D12GraphicsCommandList  pCommandList;
    ID3D12CommandQueue  pCommandQueue;
    UINT32 BreadcrumbCount;
    UINT32  pLastBreadcrumbValue;
    D3D12_AUTO_BREADCRUMB_OP  pCommandHistory;
    struct D3D12_AUTO_BREADCRUMB_NODE  pNext;
} D3D12_AUTO_BREADCRUMB_NODE
```

### 멤버

*pCommandListDebugNameA*\
형식: const char \*

미해결 명령 목록(있는 경우)의 ANSI 디버그 이름에 대한 포인터입니다.

*pCommandListDebugNameW*\
형식: const wchar\_t \*

미해결 명령 목록(있는 경우)의 와이드 디버그 이름에 대한 포인터입니다.

*pCommandQueueDebugNameA*\
형식: const char \*

미해결 명령 큐(있는 경우)의 ANSI 디버그 이름에 대한 포인터입니다.

*pCommandQueueDebugNameW*\
형식: const wchar\_t \*

미해결 명령 큐(있는 경우)의 와이드 디버그 이름에 대한 포인터입니다.

*pCommandList*\
형식: ID3D12GraphicsCommandList \*

실행 시점의 미해결 명령 목록을 나타내는 [ID3D12GraphicsCommandList 인터페이스](/reference/graphics/d3d12_xs/interfaces/ID3D12GraphicsCommandList/id3d12graphicscommandlist_xs)에 대한 포인터입니다.

*pCommandQueue*\
형식: ID3D12CommandQueue \*

미해결 명령 큐를 나타내는 [ID3D12CommandQueue 인터페이스](/reference/graphics/d3d12_xs/interfaces/ID3D12CommandQueue/id3d12commandqueue_xs)에 대한 포인터입니다.

*BreadcrumbCount*\
형식: UINT32

`pCommandHistory`가 가리키는 배열 내 [D3D12\_AUTO\_BREADCRUMB\_OP](/reference/graphics/d3d12/enums/d3d12_auto_breadcrumb_op_public) 값의 개수를 포함하는 **UINT32**입니다.

*pLastBreadcrumbValue*\
형식: UINT32 \*

관련된 명령 목록을 실행하는 동안 GPU가 완료한 마지막 렌더/컴퓨트 작업의 인덱스(`pCommandHistory`가 가리키는 배열 내)를 포함하는 상수 **UINT32**에 대한 포인터입니다.

*pCommandHistory*\
형식: D3D12\_AUTO\_BREADCRUMB\_OP \*

관련된 명령 목록에 기록된 모든 렌더/컴퓨트 작업을 나타내는 상수 [D3D12\_AUTO\_BREADCRUMB\_OP](/reference/graphics/d3d12/enums/d3d12_auto_breadcrumb_op_public) 값의 배열에 대한 포인터입니다.

*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 제품군

## 함께 보기

* [핵심 구조체](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_AUTO_BREADCRUMBS_OUTPUT](/ko/reference/graphics/d3d12/structs/d3d12_dred_auto_breadcrumbs_output_public.md)
- [D3D12_DEVICE_REMOVED_EXTENDED_DATA](/ko/reference/graphics/d3d12/structs/d3d12_device_removed_extended_data_public.md)
- [D3D12_DEVICE_REMOVED_EXTENDED_DATA1](/ko/reference/graphics/d3d12/structs/d3d12_device_removed_extended_data1_public.md)
- [D3D12_AUTO_BREADCRUMB_OP](/ko/reference/graphics/d3d12/enums/d3d12_auto_breadcrumb_op_public.md)
- [D3D12_NODE_MASK](/ko/reference/graphics/d3d12/structs/d3d12_node_mask_public.md)