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

# XtfCaptureOutputBegin

> XtfCaptureOutputBegin

# XtfCaptureOutputBegin

Inicia la captura de la salida de depuración.

<a id="syntaxSection" />

## Sintaxis

```cpp theme={null}
void XtfCaptureOutputBegin(
         PCWSTR address,
         XtfDebugStringCallback debugStringCallback,
         XtfDebugStringErrorCallback debugStringErrorCallback,
         PVOID context,
         PHANDLE hListen
)  
```

<a id="parametersSection" />

### Parámetros

*address*\
Tipo: PCWSTR

\[in] La dirección IP de la consola.

*debugStringCallback*\
Tipo: [XtfDebugStringCallback](/reference/tools/xtf/xtfapi/functions/xtfdebugstringcallback-xtfapi-xbox-windows-m)

\[in, optional] Devolución de llamada opcional que se invoca para cada cadena de depuración de salida.

*debugStringErrorCallback*\
Tipo: [XtfDebugStringErrorCallback](/reference/tools/xtf/xtfapi/functions/xtfdebugstringerrorcallback-xtfapi-xbox-windows-m)

\[in, optional] Devolución de llamada opcional que se invoca para cada error encontrado.

*context*\
Tipo: PVOID

\[in, optional] Un puntero a un objeto que se pasa a las funciones de devolución de llamada. Este objeto permite asociar cada invocación de la devolución de llamada con esta sesión de captura.

*hListen*\
Tipo: PHANDLE

\[out] El identificador que representa esta sesión de captura.

<a id="retvalSection" />

### Valor devuelto

Ninguno.

<a id="remarksSection" />

## Comentarios

Use esta función y la función [XtfCaptureOutputEnd](/reference/tools/xtf/xtfapi/functions/xtfcaptureoutputend-xtfapi-xbox-windows-m) para iniciar y detener la captura de la salida de depuración general de una consola de desarrollo. Si desea supervisar la salida de depuración de un identificador de proceso específico en una consola de desarrollo, use un cliente de monitor de depuración. Para obtener más información sobre el uso de un cliente de monitor de depuración, consulte [XtfCreateDebugMonitorClient](/reference/tools/xtf/xtfdebugmonitor/methods/xtfcreatedebugmonitorclient-xtfdebugmonitor-xbox-microsoft-m).

Debe implementar y especificar una función `XtfDebugStringCallback` en `debugStringCallback` si desea capturar cadenas de depuración de una sesión de captura. De forma similar, debe implementar y especificar una función `XtfDebugStringErrorCallback` en `debugStringErrorCallback` para capturar los errores encontrados durante una sesión de captura. Sin embargo, ninguna de las dos funciones de devolución de llamada es obligatoria.

Para dejar de capturar la salida de depuración y liberar los recursos asociados a una sesión de captura, llame a [XtfCaptureOutputEnd](/reference/tools/xtf/xtfapi/functions/xtfcaptureoutputend-xtfapi-xbox-windows-m) y especifique el identificador devuelto en `hListen` para esa sesión de captura.

<Note>Debe llamar a `XtfCaptureOutputEnd` para detener una sesión de captura. De lo contrario, la sesión de captura queda huérfana y los recursos asociados a ella no se liberan, lo que provoca una pérdida de memoria.</Note>

<a id="requirements" />

## Requisitos

**Encabezado:** xtfapi.h

**Biblioteca:** XtfApi.lib

**Plataformas compatibles:** Windows (para herramientas de consola XBOX)

<a id="seealsoSection" />

## Consulte también

[Interfaz IXtfDebugMonitorClient](/reference/tools/xtf/xtfdebugmonitor/classes/IXtfDebugMonitorClient/ixtfdebugmonitorclient-xtfdebugmonitor-xbox-microsoft-t)\
[Errores de transporte de XTF (tema con NDA)](/tools/tools-console/commandlinetools/xtf-transport-errors)\
[API de Xtf adicionales](/reference/tools/xtf/xtfapi/atoc-xtfapi)


## Related topics

- [XtfCaptureOutputEnd](/es/reference/tools/xtf/xtfapi/functions/xtfcaptureoutputend-xtfapi-xbox-windows-m.md)
- [XtfDebugStringErrorCallback](/es/reference/tools/xtf/xtfapi/functions/xtfdebugstringerrorcallback-xtfapi-xbox-windows-m.md)
- [XtfDebugStringCallback](/es/reference/tools/xtf/xtfapi/functions/xtfdebugstringcallback-xtfapi-xbox-windows-m.md)
- [PIXCaptureParameters](/es/reference/tools/pix3/structs/pixcaptureparameters.md)
- [PIXEndCapture](/es/reference/tools/pix3/functions/pixendcapture.md)