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

# XtfDebugStringCallback

> XtfDebugStringCallback

# XtfDebugStringCallback

[XtfCaptureOutputBegin](https://docs.xbox.com/ko/reference/tools/xtf/xtfapi/functions/xtfcaptureoutputbegin-xtfapi-xbox-windows-m.md)에서 캡처된 각 출력 디버그 문자열에 대해 호출되는 콜백입니다.

## Syntax

```cpp theme={null}
void *XtfDebugStringCallback(
         UINT32 processId,
         UINT32 threadId,
         UINT16 cpuGroup,
         UINT16 cpuIndex,
         UINT32 level,
         UINT32 componentId,
         UINT32 sequenceNumber,
         UINT64 interruptTime,
         UINT32 flags,
         PCWSTR sourceIdentifier,
         PCWSTR messageData,
         PVOID context
)  
```

### Parameters

*processId*\
Type: UINT32

\[in] 이 디버그 문자열에 대한 프로세스의 ID입니다.

*threadId*\
Type: UINT32

\[in] 타이틀의 스레드 ID입니다.

*cpuGroup*\
Type: UINT16

\[in] 타이틀의 CPU 그룹입니다.

*cpuIndex*\
Type: UINT16

\[in] 타이틀의 CPU 인덱스입니다.

*level*\
Type: UINT32

\[in] 내부용으로 예약되어 있습니다.

*componentId*\
Type: UINT32

\[in] 내부용으로 예약되어 있습니다.

*sequenceNumber*\
Type: UINT32

\[in] 디버그 문자열의 시퀀스 번호입니다. 이 매개 변수의 값을 통해, 드물게 디버그 문자열이 잘못된 순서로 반환될 수 있는 경우에 디버그 출력의 순서를 결정할 수 있습니다.

*interruptTime*\
Type: UINT64

\[in] 내부용으로 예약되어 있습니다.

*flags*\
Type: UINT32

\[in] 내부용으로 예약되어 있습니다.

*sourceIdentifier*\
Type: PCWSTR

\[in] 디버그 문자열의 원본입니다. 이 매개 변수는 "Title" 또는 "System"으로 설정됩니다.

*messageData*\
Type: PCWSTR

\[in] 디버그 출력 문자열입니다.

*context*\
Type: PVOID

\[in, optional] [XtfCaptureOutputBegin](https://docs.xbox.com/ko/reference/tools/xtf/xtfapi/functions/xtfcaptureoutputbegin-xtfapi-xbox-windows-m.md)에 전달되는 컨텍스트 개체에 대한 포인터입니다.

### Return value

없음.

## Remarks

이 콜백은 캡처 세션 중에 캡처된 각 출력 디버그 문자열에 대해 `XtfCaptureOutputBegin` 함수에 의해 호출됩니다. 이 콜백 함수를 [XtfDebugStringErrorCallback](https://docs.xbox.com/ko/reference/tools/xtf/xtfapi/functions/xtfdebugstringerrorcallback-xtfapi-xbox-windows-m.md) 콜백 함수와 함께 사용하여 개발 콘솔에서 일반 디버그 출력을 캡처합니다. 개발 콘솔의 특정 프로세스 ID에서 디버그 출력을 모니터링하려면 디버그 모니터 클라이언트를 사용합니다. 디버그 모니터 클라이언트 사용에 대한 자세한 내용은 [XtfCreateDebugMonitorClient](https://docs.xbox.com/ko/reference/tools/xtf/xtfdebugmonitor/methods/xtfcreatedebugmonitorclient-xtfdebugmonitor-xbox-microsoft-m.md)를 참조하세요.

## Requirements

**Header:** xtfapi.h

**Library:** XtfApi.lib

**Supported platforms:** Windows(XBOX 콘솔 도구용)

## See also

[XTF Transport Errors (NDA topic)](https://docs.xbox.com/ko/tools/tools-console/commandlinetools/xtf-transport-errors.md)\
[Additional Xtf APIs](https://docs.xbox.com/ko/reference/tools/xtf/xtfapi/atoc-xtfapi.md)


## Related topics

- [XtfDebugStringErrorCallback](https://docs.xbox.com/ko/reference/tools/xtf/xtfapi/functions/xtfdebugstringerrorcallback-xtfapi-xbox-windows-m.md)
- [XtfCaptureOutputBegin](https://docs.xbox.com/ko/reference/tools/xtf/xtfapi/functions/xtfcaptureoutputbegin-xtfapi-xbox-windows-m.md)
- [추가 Xtf API (API 콘텐츠)](https://docs.xbox.com/ko/reference/tools/xtf/xtfapi/atoc-xtfapi.md)
- [OnOutputDebugString](https://docs.xbox.com/ko/reference/tools/xtf/xtfdebugmonitor/classes/IXtfDebugMonitorCallback/methods/onoutputdebugstring-ixtfdebugmonitorcallback-xtfdebugmonitor-xbox-microsoft-m.md)
- [XTF_OUTPUT_DEBUG_STRING_DATA 구조체](https://docs.xbox.com/ko/reference/tools/xtf/xtfdebugmonitor/structures/XTF_OUTPUT_DEBUG_STRING_DATA-xtfdebugmonitor-xbox-microsoft-t.md)