Pular para o conteúdo principal

XtfCaptureOutputBegin

Inicia a captura da saída de depuração.

Sintaxe

Parâmetros

address
Tipo: PCWSTR
[in] O endereço IP do console. debugStringCallback
Tipo: XtfDebugStringCallback
[in, optional] Um retorno de chamada opcional invocado para cada cadeia de caracteres de saída de depuração. debugStringErrorCallback
Tipo: XtfDebugStringErrorCallback
[in, optional] Um retorno de chamada opcional invocado para cada erro encontrado. context
Tipo: PVOID
[in, optional] Um ponteiro para um objeto que é passado para as funções de retorno de chamada. Esse objeto permite que cada invocação de retorno de chamada seja associada a esta sessão de captura. hListen
Tipo: PHANDLE
[out] O identificador que representa esta sessão de captura.

Valor de retorno

Nenhum.

Comentários

Use esta função e a função XtfCaptureOutputEnd para iniciar e interromper a captura da 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. Você deverá implementar e especificar uma função XtfDebugStringCallback em debugStringCallback se quiser capturar cadeias de caracteres de depuração para uma sessão de captura. Da mesma forma, você deve implementar e especificar uma função XtfDebugStringErrorCallback em debugStringErrorCallback para capturar erros encontrados durante uma sessão de captura. No entanto, nenhuma das funções de retorno de chamada é obrigatória. Para interromper a captura da saída de depuração e liberar os recursos associados a uma sessão de captura, chame XtfCaptureOutputEnd e especifique o identificador retornado em hListen para essa sessão de captura.
Você deve chamar XtfCaptureOutputEnd para interromper uma sessão de captura. Caso contrário, a sessão de captura ficará órfã e os recursos associados a ela não serão liberados, causando um vazamento de memória.

Requisitos

Cabeçalho: xtfapi.h Biblioteca: XtfApi.lib Plataformas com suporte: Windows (para ferramentas de console XBOX)

Confira também

Interface IXtfDebugMonitorClient
Erros de transporte do XTF (tópico sob NDA)
APIs adicionais do Xtf
Última modificação em 6 de outubro de 2026