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

Retorno de chamada invocado para cada cadeia de caracteres de saída de depuração capturada por [XtfCaptureOutputBegin](/pt-BR/reference/tools/xtf/xtfapi/functions/xtfcaptureoutputbegin-xtfapi-xbox-windows-m).

<a id="syntaxSection" />

## Sintaxe

```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" />

### Parâmetros

*processId*\
Tipo: UINT32

\[in] A ID do processo desta cadeia de caracteres de depuração.

*threadId*\
Tipo: UINT32

\[in] A ID do thread do título.

*cpuGroup*\
Tipo: UINT16

\[in] O grupo de CPU do título.

*cpuIndex*\
Tipo: UINT16

\[in] O índice de CPU do título.

*level*\
Tipo: UINT32

\[in] Reservado para uso interno.

*componentId*\
Tipo: UINT32

\[in] Reservado para uso interno.

*sequenceNumber*\
Tipo: UINT32

\[in] O número de sequência da cadeia de caracteres de depuração. O valor desse parâmetro permite determinar a ordem da saída de depuração, nos raros casos em que as cadeias de caracteres de depuração podem ser retornadas na ordem errada.

*interruptTime*\
Tipo: UINT64

\[in] Reservado para uso interno.

*flags*\
Tipo: UINT32

\[in] Reservado para uso interno.

*sourceIdentifier*\
Tipo: PCWSTR

\[in] A origem da cadeia de caracteres de depuração. Esse parâmetro é definido como "Title" ou "System".

*messageData*\
Tipo: PCWSTR

\[in] A cadeia de caracteres de saída de depuração.

*context*\
Tipo: PVOID

\[in, optional] Um ponteiro para um objeto de contexto, passado para [XtfCaptureOutputBegin](/pt-BR/reference/tools/xtf/xtfapi/functions/xtfcaptureoutputbegin-xtfapi-xbox-windows-m).

<a id="retvalSection" />

### Valor de retorno

Nenhum.

<a id="remarksSection" />

## Comentários

Esse retorno de chamada é invocado pela função `XtfCaptureOutputBegin` para cada cadeia de caracteres de saída de depuração capturada durante uma sessão de captura. Use essa função de retorno de chamada, junto com uma função de retorno de chamada [XtfDebugStringErrorCallback](/pt-BR/reference/tools/xtf/xtfapi/functions/xtfdebugstringerrorcallback-xtfapi-xbox-windows-m), para capturar a saída de depuração geral de um console de desenvolvimento. Se você quiser monitorar a saída de depuração de uma ID de processo específica em um console de desenvolvimento, use um cliente de monitor de depuração. Para obter mais informações sobre como usar um cliente de monitor de depuração, confira [XtfCreateDebugMonitorClient](/pt-BR/reference/tools/xtf/xtfdebugmonitor/methods/xtfcreatedebugmonitorclient-xtfdebugmonitor-xbox-microsoft-m).

<a id="requirementsSection" />

## Requisitos

**Cabeçalho:** xtfapi.h

**Biblioteca:** XtfApi.lib

**Plataformas com suporte:** Windows (para ferramentas de console XBOX)

## Confira também

[Erros de transporte do XTF (tópico sob NDA)](/pt-BR/tools/tools-console/commandlinetools/xtf-transport-errors)\
[APIs adicionais do Xtf](/pt-BR/reference/tools/xtf/xtfapi/atoc-xtfapi)


## Related topics

- [XtfDebugStringErrorCallback](/pt-BR/reference/tools/xtf/xtfapi/functions/xtfdebugstringerrorcallback-xtfapi-xbox-windows-m.md)
- [XtfCaptureOutputBegin](/pt-BR/reference/tools/xtf/xtfapi/functions/xtfcaptureoutputbegin-xtfapi-xbox-windows-m.md)
- [Método IXtfDebugMonitorCallback::OnOutputDebugString](/pt-BR/reference/tools/xtf/xtfdebugmonitor/classes/IXtfDebugMonitorCallback/methods/onoutputdebugstring-ixtfdebugmonitorcallback-xtfdebugmonitor-xbox-microsoft-m.md)
- [Estrutura XTF_OUTPUT_DEBUG_STRING_DATA](/pt-BR/reference/tools/xtf/xtfdebugmonitor/structures/XTF_OUTPUT_DEBUG_STRING_DATA-xtfdebugmonitor-xbox-microsoft-t.md)
- [Método IXtfDebugMonitorClient::Start](/pt-BR/reference/tools/xtf/xtfdebugmonitor/classes/IXtfDebugMonitorClient/methods/start-ixtfdebugmonitorclient-xtfdebugmonitor-xbox-microsoft-m.md)