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

# XtfDebugStringCallback

> XtfDebugStringCallback

# XtfDebugStringCallback

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

<a id="syntaxSection" />

## 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
)  
```

<a id="parametersSection" />

### 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](/reference/tools/xtf/xtfapi/functions/xtfcaptureoutputbegin-xtfapi-xbox-windows-m)에 전달되는 컨텍스트 개체에 대한 포인터입니다.

<a id="retvalSection" />

### Return value

없음.

<a id="remarksSection" />

## Remarks

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

<a id="requirementsSection" />

## Requirements

**Header:** xtfapi.h

**Library:** XtfApi.lib

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

## See also

[XTF Transport Errors (NDA topic)](/tools/tools-console/commandlinetools/xtf-transport-errors)\
[Additional Xtf APIs](/reference/tools/xtf/xtfapi/atoc-xtfapi)


## Related topics

- [XtfDebugStringErrorCallback](/ko/reference/tools/xtf/xtfapi/functions/xtfdebugstringerrorcallback-xtfapi-xbox-windows-m.md)
- [XtfCaptureOutputBegin](/ko/reference/tools/xtf/xtfapi/functions/xtfcaptureoutputbegin-xtfapi-xbox-windows-m.md)
- [IXtfDebugMonitorCallback::OnOutputDebugString 메서드](/ko/reference/tools/xtf/xtfdebugmonitor/classes/IXtfDebugMonitorCallback/methods/onoutputdebugstring-ixtfdebugmonitorcallback-xtfdebugmonitor-xbox-microsoft-m.md)
- [XTF_OUTPUT_DEBUG_STRING_DATA 구조체](/ko/reference/tools/xtf/xtfdebugmonitor/structures/XTF_OUTPUT_DEBUG_STRING_DATA-xtfdebugmonitor-xbox-microsoft-t.md)
- [IXtfDebugMonitorClient::Start 메서드](/ko/reference/tools/xtf/xtfdebugmonitor/classes/IXtfDebugMonitorClient/methods/start-ixtfdebugmonitorclient-xtfdebugmonitor-xbox-microsoft-m.md)
